reddit-skill_skill

Overview

This skill connects your account to Reddit so you can read subreddits, search content, vote, save, and manage your inbox. It also lets you create posts and comments, but it requires explicit confirmation before any submission. The skill returns command outputs in JSON for easy integration.

How this skill works

The skill authenticates with Reddit using script-type OAuth credentials and exposes commands to browse frontpage, individual subreddits, and search results. It supports actions on Reddit items (vote, save, unsave), fetches user content (submissions, comments, inbox, subscriptions), and prepares posts or comments for submission only after you confirm the exact subreddit, title, and content. Outputs are JSON so you can programmatically parse results or display them in an app.

When to use it

• Browse frontpage, specific subreddits, or search Reddit content programmatically
• Check your Reddit inbox, submissions, comments, or subscriptions
• Upvote, downvote, save, or unsave posts and comments
• Prepare or submit a text or link post and post comments or replies (with confirmation)
• Fetch JSON-formatted results for integration into other tools or scripts

Best practices

• Always review the preview before confirming any post or comment — explicit confirmation is required before submission
• Use subreddit and sort filters to narrow results and limit parameter to avoid excessive data
• Keep your OAuth client_id and client_secret secure and store credentials in a private configuration path
• Use thing IDs (t1_, t3_, t4_) from command output or URLs when voting, commenting, or saving to avoid ambiguity
• Parse the JSON output programmatically for robust UI or automation handling

Example use cases

• Search Reddit for recent discussions about a product and collect top threads in JSON for analysis
• Open a subreddit feed sorted by rising to surface new posts for community moderation or curation
• Prepare a text post and show the preview, then ask user to confirm before submitting to the chosen subreddit
• Fetch your Reddit inbox and list unread messages so you can triage replies and notifications
• Programmatically upvote or downvote items by passing thing IDs returned from previous queries