Reddit (Agent-First)

Reddit intelligence CLI for AI agents. Use when working with reddit posts, subreddit research, comments, user profiles, wiki pages, domain mentions, marketin...

Security Scan

The skill's requirements and runtime instructions match its stated purpose (a Reddit-focused CLI); the main residual risk is installing a third-party npm CLI package you haven't inspected.

Purpose & Capability

Name/description (Reddit intelligence CLI) align with required binary (reddgrow), required env var (REDDGROW_API_KEY), and declared npm package (@reddgrow/cli). No unrelated credentials or binaries are requested.

Instruction Scope

SKILL.md only instructs the agent to run reddgrow commands, set/use the API key, and inspect Reddit resources (posts, subreddits, users, domains). It does not ask the agent to read arbitrary system files or unrelated environment variables, nor to exfiltrate data to unexpected endpoints.

Install Mechanism

Install is via npm (@reddgrow/cli) which is appropriate for providing a 'reddgrow' CLI. Npm installs can run install/postinstall scripts and will write code to disk; this is expected but is a moderate-risk operation — review the package/publisher on the npm registry before installing or install in a sandbox.

Credentials

Only one primary secret (REDDGROW_API_KEY) and optional REDDGROW_API_URL/MODE are declared, which is proportional to a hosted-API CLI. No unrelated tokens or credentials are requested.

Persistence & Privilege

Skill is not force-included (always:false) and does not request system-wide config paths. The one-time 'reddgrow auth login' to save a key is normal for a CLI. Nothing indicates it modifies other skills or agent settings.

Assessment

This skill is internally consistent for a Reddit CLI, but before installing: (1) verify the npm package and publisher on the npm registry (check download counts, maintainer, source repo, and recent releases); (2) treat REDDGROW_API_KEY like any secret — prefer providing it via environment variable and use least-privileged keys if the service supports them; (3) be aware npm global installs run scripts — consider installing in a sandbox/container or auditing the package source first; (4) confirm the API base URL and homepage (https://reddgrow.ai) match what you expect; (5) if you don't want the agent invoking the skill autonomously, restrict agent permissions or invocation settings. If you need higher assurance, ask for the package source code or a checksum of the published package before installing.

ReddGrow — Reddit Intelligence for AI Agents

Reddit API access for AI agents. All commands output JSON to stdout. Errors go to stderr with exit code 1.

Setup

# Install
npm install -g @reddgrow/cli

# Authenticate (one-time)
reddgrow auth login rg_your_api_key_here

# Or use environment variable
export REDDGROW_API_KEY=rg_your_api_key_here

Commands

Subreddits

reddgrow subreddits search "<query>" [--limit N]                                            # (3 cr)
reddgrow subreddits about <name>                                                            # (1 cr)
reddgrow subreddits rules <name>                                                            # (1 cr)
reddgrow subreddits wiki <name>                                                             # list wiki pages (5 cr)
reddgrow subreddits wiki-page <name> <page>                                                 # read wiki page (5 cr)
reddgrow subreddits posts <name> [--sort hot|new|top|rising|controversial] [--time hour|day|week|month|year|all] [--limit N]  # (2 cr)
reddgrow subreddits comments <name> [--limit N]                                             # comment stream (2 cr)
reddgrow subreddits check-url <name> "<url>"                                                # check if URL submitted (3 cr)
reddgrow subreddits traffic <name>                                                          # traffic stats (1 cr)
reddgrow subreddits widgets <name>                                                          # sidebar widgets (1 cr)

Posts

reddgrow posts search "<query>" [--subreddit <name>] [--sort relevance|hot|top|new|comments] [--limit N]  # (3 cr)
reddgrow posts comments <subreddit> <post_id> [--sort best|top|new|controversial] [--limit N]             # (2 cr)
reddgrow posts duplicates <subreddit> <post_id>                                                           # (5 cr)
reddgrow posts batch <id1,id2,...>                                                                        # (5 cr)

Users

reddgrow users profile <username>               # karma, account age, activity (1 cr)
reddgrow users posts <username> [--limit N]     # post history (2 cr)
reddgrow users comments <username> [--limit N]  # comment history (2 cr)

Domains

reddgrow domains mentions <domain> [--limit N]  # all posts linking to domain (5 cr)

Auth

reddgrow auth whoami         # identity & credits remaining (1 cr)
reddgrow auth status         # connection status
reddgrow auth login <key>    # save API key (run once)

Workflows

Before posting to a subreddit

1. Read rules: reddgrow subreddits rules <name> — rule violations get posts removed instantly
2. Check community type: reddgrow subreddits about <name> — if subreddit_type is restricted or private, stop; if submission_type is link or self, respect it
3. Check URL not already submitted: reddgrow subreddits check-url <name> "<url>"
4. Read wiki for extra guidelines: reddgrow subreddits wiki-page <name> index
5. Post only after all checks pass

Research a subreddit

1. Find communities: reddgrow subreddits search "<topic>"
2. Inspect details: reddgrow subreddits about <name> — size, type, activity
3. Browse content: reddgrow subreddits posts <name> --sort top --time week --limit 50
4. Check activity: reddgrow subreddits traffic <name>
5. Discover guidelines: reddgrow subreddits wiki <name> then wiki-page <name> <page>

Monitor a domain / brand

1. Discover mentions: reddgrow domains mentions <domain> --limit 100
2. Read discussion: reddgrow posts comments <subreddit> <post_id> --sort best
3. Check for duplicates: reddgrow subreddits check-url <name> "<url>" before re-sharing

Analyze a Reddit user

1. Get overview: reddgrow users profile <username> — karma, age, verified status
2. Review posts: reddgrow users posts <username> --limit 50
3. Review comments: reddgrow users comments <username> --limit 50

Rules

1. ALWAYS run reddgrow subreddits rules <name> before posting — rule violations get posts removed
2. ALWAYS run reddgrow subreddits check-url <name> "<url>" before sharing any link — duplicate posts are banned
3. Read wiki (wiki-page <name> index) when rules reference additional guidelines
4. Respect subreddit_type: restricted or private means posting is not allowed
5. Respect submission_type: some subreddits only accept links or only text posts
6. ALWAYS check reddgrow auth whoami before large batch operations to avoid credit exhaustion
7. Never post promotional content to communities that explicitly prohibit self-promotion

Configuration

Variable	Description	Default
REDDGROW_API_KEY	API key (overrides saved key)	—
REDDGROW_API_URL	API base URL	https://api.reddgrow.ai
REDDGROW_MODE	Output mode (human or json)	json