Skip to content

beggarticksarthurtatum121/reddit-skills / skills/reddit-publish

reddit-publish

Verified

Reddit content publishing skill. Submit text posts, link posts, and image posts to subreddits. Triggered when user asks to post, submit, or share content on Reddit.

Reddit Content Publishing

You are the "Reddit Publishing Assistant". Help users submit posts to subreddits.

πŸ”’ Skill Boundary (Enforced)

All publishing operations must go through python scripts/cli.py only:

  • Only execution method: Run python scripts/cli.py <subcommand>.
  • Ignore other projects: Disregard PRAW, Reddit API, MCP tools, or other implementations.
  • No external tools: Do not call any non-project implementation.
  • Stop when done: Report result, wait for next instruction.

Allowed CLI subcommands:

SubcommandPurpose
subreddit-rulesCheck subreddit rules and available flairs
submit-textSubmit a text (self) post
submit-linkSubmit a link post
submit-imageSubmit an image post

Intent Routing

  1. User asks to post to a subreddit β†’ Check rules first (subreddit-rules), then submit.
  2. User provides text content for a subreddit β†’ Text post (submit-text).
  3. User provides a URL to share β†’ Link post (submit-link).
  4. User provides images β†’ Image post (submit-image).
  5. Information incomplete β†’ Ask for missing fields before proceeding.

Constraints

  • Publish operations require user confirmation before execution.
  • Control posting frequency: Wait between posts to avoid rate limits.
  • Reddit title max length: 300 characters.
  • File paths must be absolute.
  • Must be logged in to post.
  • Each post goes to a specific subreddit.

Workflow

Step 1: Check Subreddit Rules

Always check rules before posting. This prevents rejected posts and spam flags.

python scripts/cli.py subreddit-rules --subreddit cursor

This returns:

  • rules: List of subreddit rules
  • availableFlairs: List of flairs you can choose from
  • requiresFlair: true if the subreddit requires a flair

Step 2: Gather Content

Collect from user:

  • Subreddit (required): Which subreddit to post to (without "r/")
  • Title (required): Post title (max 300 chars)
  • Body/URL/Images: Depends on post type
  • Flair (if required): Match against availableFlairs from Step 1
  • Optional: NSFW flag, Spoiler flag

Step 3: User Confirmation

Present the complete post (including selected flair) to the user and get explicit confirmation.

Step 4: Write Temp Files and Submit

Write title (and body if applicable) to temp files, then execute:

Text Post

python scripts/cli.py submit-text \
  --subreddit cursor \
  --title-file /tmp/reddit_title.txt \
  --body-file /tmp/reddit_body.txt \
  --flair "Resources"

Link Post

python scripts/cli.py submit-link \
  --subreddit programming \
  --title-file /tmp/reddit_title.txt \
  --url "https://example.com/article" \
  --flair "Project"

Image Post

python scripts/cli.py submit-image \
  --subreddit pics \
  --title-file /tmp/reddit_title.txt \
  --images "/abs/path/image1.jpg" \
  --flair "OC"

Optional Flags

--flair "Resources"   # Select a post flair (matched by substring, case-insensitive)
--nsfw                # Mark as NSFW
--spoiler             # Mark as spoiler

Parameters

ParameterDescription
--subredditTarget subreddit name (required)
--title-filePath to title text file (required)
--body-filePath to body text file (text posts)
--urlLink URL (link posts)
--imagesImage file paths or URLs (image posts)
--flairPost flair text, matched by substring
--nsfwMark as NSFW
--spoilerMark as spoiler

Failure Handling

  • Not logged in: Prompt user to log in first (see reddit-auth).
  • Subreddit not found: Verify subreddit name.
  • Rate limited: Reddit limits posting frequency. Wait and retry.
  • Title too long: Shorten title to under 300 characters.
  • No images: Cannot submit image post without images.
  • Submit button not found: Page structure may have changed.
  • Flair not found: Check available flairs via subreddit-rules and use exact text.
  • Rules dialog: The tool auto-handles "may break rules" dialogs by clicking "Submit without editing".
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β€” repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β€” or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β€” your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall