tweet-to-reddit-crosspost - SKILL.md Agent Skill

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:

Ask for a tweet/X URL.
Ensure Reddit OAuth is configured (run scripts/oauth_setup.py if needed).
Run scripts/tweet_to_reddit.py in dry-run mode first.
Show the proposed subreddit, title, and body to the user.
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.