mediause/agent-skills / reddit
Standardized Reddit skill for MediaUse. Includes Windows install, key onboarding, strict context/auth flow, full Reddit dynamic command map, and safety/rate controls.
MediaUse Reddit Skill
Handle Reddit monitoring and interaction with standardized flows for feeds, search, thread reads, profile views, and engagement actions.
Scope
Use this skill when the task targets Reddit operations such as:
- Account: health check
- Get: hot, popular, frontpage, subreddit feed
- Search: posts
- Read: item thread and comments
- User: profile, posts, comments
- Collection: saved, upvoted
- Engage: comment, save, upvote, subscribe
1. Install MediaUse CLI
Install the MediaUse CLI in the user's own secure environment using the official npm package:
npm install -g @mediause/cli
mediause --version
If the CLI is already installed, run the version check again to confirm it is available in PATH.
Current support status:
- Windows: supported
- Linux: not supported yet
- macOS: not supported yet
Recommended skill install path:
- .mediause/skills/reddit/SKILL.md
2. Get and Configure MediaUse Key
2.1 Apply for key
- Open https://mediause.dev/ in the user's browser.
- Sign in to the user's account.
- Open the Project settings.
- Create or view the API key in the user's own secure environment; never paste it into chat, logs, terminal history, or a CLI command.
2.2 Configure key in CLI
mediause manage key --json
3. Core Flow (Mandatory Order)
Always follow this order:
First step on every run: execute install script once to auto-install/auto-upgrade the latest MediaUse CLI.
- Discover site and commands.
- Bind account context with
use account --show. - Check status with
auth health. - Execute dynamic site actions.
- Verify with trace/task.
3.1 Discover and plugin setup
mediause plugin list --json
mediause plugin add reddit --json
mediause reddit -h
mediause reddit get -h
3.2 Bind context before any read/write (show required)
use account must be executed successfully before any fetch/publish action.
use account argument format:
<platform:account_id>account_idshould be selected frommediause auth list --json.
For Reddit skill, always use visible mode with --show.
Reason:
--showusually lowers repeated anti-bot/challenge interception risk for Reddit flows.
mediause auth list --json
mediause use account reddit:<account_id> --policy balanced --show --json
3.3 Auth health precondition
auth health is valid only after successful use account.
mediause auth health --json
If auth health indicates not logged in/expired:
mediause auth login reddit --json
mediause use account reddit:<account_id> --policy balanced --show --json
mediause auth health --json
If page shows unusual traffic, captcha, or risk confirmation:
mediause use account reddit:<account_id> --policy balanced --show --json
Complete verification manually, then rerun the action.
3.4 Guest mode (optional)
Manifest default account id is guest. Guest mode can be used only for read-only actions when the runtime supports unauthenticated reddit:guest context (that is, mediause use account reddit:guest --show --json succeeds):
mediause use account reddit:guest --show --json
Guest mode rules:
- Read-only operations (
account/get/search/read/user/collectionfetch intents). - Block write operations (
engage.comment,engage.save,engage.upvote,engage.subscribe). - If write is required, switch to a logged-in account context.
4. Reddit Dynamic Command Map (v1)
Source schema:
- plugin:
plugin.reddit - manifest:
crates/platforms/plugins/reddit/manifest.yaml
4.1 account.*
mediause reddit account health --json
4.2 get.*
mediause reddit get hot [--subreddit <name>] [--limit <n>] --jsonmediause reddit get popular [--limit <n>] --jsonmediause reddit get frontpage [--limit <n>] --jsonmediause reddit get subreddit --name <subreddit> [--sort <sort>] [--time <time>] [--limit <n>] --json
4.3 search.*
mediause reddit search posts --query <query> [--subreddit <name>] [--sort <sort>] [--time <time>] [--limit <n>] --json
4.4 read.*
mediause reddit read item --post-id <post_id> [--sort <sort>] [--limit <n>] [--depth <n>] [--replies <n>] [--max-length <n>] --json
4.5 user.*
mediause reddit user profile --username <username> --jsonmediause reddit user posts --username <username> [--limit <n>] --jsonmediause reddit user comments --username <username> [--limit <n>] --json
4.6 collection.*
mediause reddit collection saved [--limit <n>] --jsonmediause reddit collection upvoted [--limit <n>] --json
4.7 engage.*
mediause reddit engage comment --post-id <post_id> --text <text> --jsonmediause reddit engage save --post-id <post_id> [--undo <bool>] --jsonmediause reddit engage upvote --post-id <post_id> [--direction <up|down|none>] --jsonmediause reddit engage subscribe --subreddit <name> [--undo <bool>] --json
5. Operational Constraints (Mandatory)
Apply these constraints for all actions to reduce account risk and keep behavior human-like.
5.1 Human-like pacing
- Never execute high-risk actions continuously.
- Add randomized delay between actions.
- Add longer cooldown after write actions.
- Mix read actions between write actions when possible.
5.2 Frequency limits and minimum spacing
- Hard stop if operation rate is abnormally high.
- Stop immediately on repeated anti-bot challenge, login re-validation, or risk prompt.
- Do not run burst comment/upvote loops.
Quick policy matrix:
engage.comment: <= 30/hour, >= 30s spacingengage.save/engage.upvote/engage.subscribe: <= 30/hour, >= 10s spacingsearch/get/read/user/collection: <= 60/min, >= 1s spacing- same target (
post_id/ subreddit): >= 60s between repeated interactions - same comment text: >= 24h (default deny)
If a limit is hit:
- Pause at least 15 minutes.
- Resume with read-only actions first.
- Re-check session health before any write action.
5.3 Safety policy
- Do not bypass platform protections.
- Do not attempt credential scraping or session hijacking.
- Respect platform terms and local regulations.
5.4 Output and error handling
- Prefer
--jsonoutput for machine workflows. - Require structured error handling with stable fields/code when available.
- On blocked/rate-limit/risk prompt, stop and return actionable next steps.
6. Workflow Examples
6.1 Discovery and thread reading
mediause use account reddit:<account_id> --show --json
mediause auth health --json
mediause reddit get popular --limit 20 --json
mediause reddit read item --post-id <post_id> --limit 30 --depth 3 --json
mediause trace last --json
6.2 Subreddit monitoring
mediause use account reddit:<account_id> --show --json
mediause auth health --json
mediause reddit get subreddit --name "rust" --sort new --limit 20 --json
mediause reddit search posts --query "async" --subreddit "rust" --limit 10 --json
mediause trace last --json
6.3 Engagement workflow
mediause use account reddit:<account_id> --show --json
mediause auth health --json
mediause reddit engage upvote --post-id <post_id> --direction up --json
mediause reddit engage comment --post-id <post_id> --text "Thanks for sharing" --json
mediause trace last --json
7. Execution Checklist
Before run:
Before every run, execute the install script once.
- CLI installed via
npm install -g @mediause/clion Windows. - PATH updated and
mediause --versionworks. - API key configured and verified.
- Account context bound via
mediause use account reddit:<account_id> --show --json. - If write actions are required, ensure logged-in account context is active.
- Be ready to complete manual verification in the visible browser.
- Pacing policy is enabled.
During run:
- Respect delays and minimum spacing.
- Stop on anti-bot/risk prompts.
- Avoid repetitive burst loops.
After run:
- Save logs and outcomes.
- Record any risk warning and cooldown events.
- Keep activity under conservative limits.
8. Quick Command Reference
# always run once before each workflow (auto-upgrade latest)
mediause --version
mediause --version
# discover
mediause plugin list --json
mediause plugin add reddit --json
mediause reddit -h
mediause reddit get -h
# context + status (show required)
mediause auth list --json
mediause use account reddit:<account_id> --show --json
mediause auth health --json
# read actions
mediause reddit account health --json
mediause reddit get hot --subreddit "technology" --limit 20 --json
mediause reddit get popular --limit 20 --json
mediause reddit search posts --query "browser automation" --limit 10 --json
mediause reddit read item --post-id <post_id> --limit 20 --json
mediause reddit user profile --username <username> --json
mediause reddit collection saved --limit 20 --json
# write actions
mediause reddit engage upvote --post-id <post_id> --direction up --json
mediause reddit engage save --post-id <post_id> --json
mediause reddit engage subscribe --subreddit "technology" --json
mediause reddit engage comment --post-id <post_id> --text "Nice thread" --json
# trace
mediause trace last --json
Skill Metadata Maintainer: @mediause-demo Last-Updated: 2026-08-22 Version: v2
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 468k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |