tweet-to-reddit-crosspost

name	tweet-to-reddit-crosspost
description	Find relevant Reddit communities and crosspost from a tweet/X link with a safe proposal-first workflow. Use when a user wants to turn a tweet into a Reddit post, discover best-fit subreddits, draft title/body, set up Reddit OAuth, and optionally publish.

Tweet to Reddit Crosspost

Follow this deterministic flow:

1. Ask for a tweet/X URL.
2. Ensure Reddit OAuth is configured (run scripts/oauth_setup.py if needed).
3. Run scripts/tweet_to_reddit.py in dry-run mode first.
4. Show the proposed subreddit, title, and body to the user.
5. Only publish after explicit user confirmation.

Commands

Dry run (recommended first):

python3 "skills/tweet-to-reddit-crosspost/scripts/tweet_to_reddit.py" \
  --tweet-url "<tweet-url>"

Publish:

python3 "skills/tweet-to-reddit-crosspost/scripts/tweet_to_reddit.py" \
  --tweet-url "<tweet-url>" \
  --post \
  --yes-post

Override tweet text when URL parsing or fetch fails:

python3 "skills/tweet-to-reddit-crosspost/scripts/tweet_to_reddit.py" \
  --tweet-url "<tweet-url>" \
  --text-override "<tweet text>"

Target a specific subreddit:

python3 "skills/tweet-to-reddit-crosspost/scripts/tweet_to_reddit.py" \
  --tweet-url "<tweet-url>" \
  --subreddit "Entrepreneur"

OAuth bootstrap

Run:

python3 "skills/tweet-to-reddit-crosspost/scripts/oauth_setup.py" \
  --client-id "<client_id>" \
  --client-secret "<client_secret>" \
  --redirect-uri "http://localhost:8080/callback"

This stores refresh-token credentials in:

• ~/.config/tweet-to-reddit-skill/reddit_credentials.json

Rules

• Always run proposal-first (--post omitted) before posting.
• Never auto-post without explicit user consent.
• Respect subreddit rules and posting policies.
• If no good subreddit match is found, ask user to select one manually.