Reddit Intelligence For Agents

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 declared purpose (a Reddit intelligence CLI) matches its requirements (a reddgrow binary and REDDGROW_API_KEY) and its runtime instructions; main risk is the npm install origin and how the CLI stores the API key.

Purpose & Capability

Name/description match what is required: the skill needs a reddgrow CLI and an API key (REDDGROW_API_KEY), which is consistent with a Reddit intelligence tool. Minor metadata quirk: SKILL.md lists version 0.1.6 while registry metadata shows 0.1.7 and registry 'homepage' is missing even though SKILL.md references https://reddgrow.ai — this is a small inconsistency but does not undermine purpose alignment.

Instruction Scope

SKILL.md explicitly instructs the agent to run reddgrow CLI commands and to provide an API key. It does not ask the agent to read unrelated files, other credentials, or system state. It does instruct using 'reddgrow auth login' which will persist the API key via the CLI (normal for a CLI but worth checking where/how it is stored). No instructions to transmit data to unexpected endpoints are present (api base is reddgrow's API).

Install Mechanism

Install is via npm package @reddgrow/cli which will provide the reddgrow binary — this is expected for a Node-based CLI. Caveats: global npm installs can run arbitrary code (postinstall), there is no checksum/lockfile shown, and the registry metadata lacks a homepage entry (though SKILL.md references https://reddgrow.ai). Recommend verifying the package on the npm registry, inspecting its package.json and any postinstall scripts, and prefer a constrained install environment (or audit the package) before global installation.

Credentials

The only required environment variable is REDDGROW_API_KEY (declared as primaryEnv), which is appropriate for an API-backed CLI. SKILL.md also documents optional REDDGROW_API_URL and REDDGROW_MODE — those are reasonable. No unrelated secrets or multiple unrelated credentials are requested.

Persistence & Privilege

Skill is not forced-always and is user-invocable; model invocation is allowed (normal). The CLI's 'auth login' will save credentials locally (expected), so verify where the CLI writes credentials (e.g., home directory, system keychain) and whether saved credentials are stored encrypted. The skill does not request to modify other skills or system-wide agent configs.

Assessment

This skill appears coherent for its stated purpose, but take these precautions before installing: 1) Inspect the @reddgrow/cli package on npm (check publisher, version, package.json, and any postinstall scripts) and confirm the source (prefer GitHub repo or official site). 2) Prefer supplying the API key via REDDGROW_API_KEY in the environment rather than using 'reddgrow auth login' if you are unsure where the CLI stores credentials; if you must use login, locate and inspect the saved token file and consider using a dedicated service account key with limited scope/credits. 3) Install in a controlled environment (container or VM) if you want to limit risk from npm postinstall scripts. 4) Verify billing/credit implications (commands mention credit costs) and monitor usage. 5) Note the small metadata/version mismatch (0.1.6 vs 0.1.7) and missing homepage in registry metadata — you may want to confirm the canonical homepage/repo before trusting the package.

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