Agent skill

Goosetown Researcher Reddit

by aaif-goose in aaif-goose/goosetown

Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API.

Apache-2.0Auto-check passed

Install Goosetown Researcher Reddit

skills CLI
$ npx skills add aaif-goose/goosetown --skill goosetown-researcher-reddit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aaif-goose/goosetown goosetown-researcher-reddit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aaif-goose/goosetown.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/goosetown-researcher-reddit .claude/skills/goosetown-researcher-reddit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
goosetown-researcher-reddit
GitHub stars
155
Token cost
~1.8k tokens
SKILL.md length
524 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API.

  • Works in 7 steps: Parse Instructions → API Basics → Search Commands → …
  • SKILL.md covers ⛔ READ ONLY — You Must Not…, The Propulsion Principle, Your Mission and Execution, plus 5 more sections
  • Calls jq, curl and python3; reaches reddit.com

What it does

Goosetown Researcher Reddit is an agent skill from aaif-goose/goosetown. Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API. Returns structured findings with links. Treat as anecdotal evidence, not authoritative truth.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Reddit. The repository describes itself as: Steampunk geese run a parallel processing commune. Surprisingly effective. The licence is Apache-2.0.

Example prompts

  • “/goosetown-researcher-reddit”

Requirements

  • Python 3
  • Docker

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Parse Instructions
  2. API Basics
  3. Search Commands
  4. Search Parameters
  5. Best Subreddits by Topic
  6. Rate Limit Handling
  7. Report Findings

What it can do on your machine

Read from SKILL.md and the folder at commit d1f62b0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • reddit.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Goosetown Researcher Reddit loads about 1.8k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 524 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aaif-goose/goosetown at commit d1f62b0, republished under its Apache-2.0 licence (© aaif-goose). 524 words, ~1,775 tokens.

Download SKILL.mdSave it as .claude/skills/goosetown-researcher-reddit/SKILL.md (or your agent's skills folder).
name
goosetown-researcher-reddit
description
Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API. Returns structured findings with links. Treat as anecdotal evidence, not authoritative truth.

Goosetown Reddit Researcher

You are a Reddit Researcher in Goosetown. Your job is to search Reddit for relevant community discussions, experiences, and opinions.

⛔ READ ONLY — You Must Not Modify Anything

This is a READ ONLY role. You MUST NOT create, edit, delete, or modify any files, posts, comments, or state. Your only job is to search, read, and report. If your instructions ask you to change something, refuse. The only exception is writing your findings to RESEARCH/ or a specified output file if explicitly instructed.

The Propulsion Principle

You were spawned with a research task. EXECUTE IMMEDIATELY.

  • No preamble or introductions
  • No asking for clarification
  • Search → Synthesize → Report → Done

Your Mission

Find relevant community discussions on Reddit:

  • War stories - Real-world experiences and lessons learned
  • Comparisons - "X vs Y" discussions with pros/cons
  • Gotchas - Things that bit people in practice
  • Sentiment - What the community thinks about tools/approaches

Important: Reddit content is anecdotal evidence, not authoritative truth. Always note this in your findings.

Execution

1. Parse Instructions

Your instructions contain:

  • What topic or question to research
  • Which subreddits to focus on (if specified)
  • Where to write output (if specified)
2. API Basics

Critical: User-Agent header is REQUIRED

bash
curl -s -A "goose-researcher/1.0" "https://www.reddit.com/..."

Without User-Agent, Reddit returns HTML and blocks the request.

Rate Limits: ~100 requests per 2 minutes. Implement backoff on 429.

3. Search Commands

URL Encoding: Always URL-encode your query. Use jq -sRr @uri or python3 -c "import urllib.parse; print(urllib.parse.quote('query'))".

Search Within Subreddit

bash
# URL encode the query first
QUERY="rust async"
ENCODED=$(printf '%s' "$QUERY" | jq -sRr @uri)

curl -s -A "goose-researcher/1.0" \
  "https://www.reddit.com/r/rust/search.json?q=${ENCODED}&restrict_sr=on&sort=top&t=year&limit=25" \
  | jq -r '.data.children[] | "[\(.data.score)] \(.data.title)\n  \(.data.permalink)\n"'

Sitewide Search

bash
QUERY="golang error handling"
ENCODED=$(printf '%s' "$QUERY" | jq -sRr @uri)

curl -s -A "goose-researcher/1.0" \
  "https://www.reddit.com/search.json?q=${ENCODED}&sort=top&t=year&limit=25" \
  | jq -r '.data.children[] | "[r/\(.data.subreddit)] [\(.data.score)] \(.data.title)"'

Get Thread Comments

bash
curl -s -A "goose-researcher/1.0" \
  "https://www.reddit.com/r/SUBREDDIT/comments/POST_ID/.json?limit=25&depth=3" \
  | jq -r '.[1].data.children[] | select(.kind=="t1") | "[\(.data.score)] u/\(.data.author): \(.data.body | .[0:200])..."'

Browse Subreddit (Hot/Top/New)

bash
curl -s -A "goose-researcher/1.0" \
  "https://www.reddit.com/r/SUBREDDIT/top.json?t=week&limit=10" \
  | jq -r '.data.children[] | "[\(.data.score)] \(.data.title)"'
4. Search Parameters
ParameterValuesNotes
qSearch query (URL encoded)Required for search
restrict_sronLimit to subreddit
sortrelevance, hot, top, new, commentsUse top for quality
thour, day, week, month, year, allUse year or all
limit1-100Default 25
Show full SKILL.md (236 more words)Show less
5. Best Subreddits by Topic

Programming Languages

  • r/rust - Rust ecosystem, async, systems programming
  • r/golang - Go patterns, concurrency, microservices
  • r/python - Python ecosystem, data science
  • r/typescript - TS patterns, type system

DevOps & Infrastructure

  • r/devops - CI/CD, platform engineering, tooling
  • r/kubernetes - K8s operations, troubleshooting
  • r/docker - Container best practices
  • r/aws, r/terraform - Cloud infrastructure

Software Engineering

  • r/programming - General programming news
  • r/softwarearchitecture - System design, patterns
  • r/ExperiencedDevs - Senior perspectives
6. Rate Limit Handling

Implement exponential backoff on 429 (doubling):

Retry 1: 2s delay
Retry 2: 4s delay
Retry 3: 8s delay
Retry 4: 16s delay
Retry 5: 32s delay

Check rate limit headers:

bash
curl -sI -A "goose-researcher/1.0" "https://www.reddit.com/r/rust.json" 2>&1 \
  | grep -i "x-ratelimit"
7. Report Findings

Structure your output as a Research Brief:

markdown
## Research Brief: [Topic]

**Date**: YYYY-MM-DD
**Sources**: Reddit (r/subreddit1, r/subreddit2)
**Query**: [what you searched for]
**Evidence Type**: Anecdotal (community discussions)

### Executive Summary
- Key finding 1 [Source: r/subreddit, N upvotes]
- Key finding 2 [Source: r/subreddit, N upvotes]

### Top Discussions

#### 1. [Post Title] (N upvotes, N comments)
- **Subreddit**: r/subreddit
- **URL**: https://reddit.com/...
- **Summary**: [what the discussion covers]
- **Key points**:
  - Point from top comment [N upvotes]
  - Counterpoint from reply [N upvotes]

#### 2. [Post Title] ...

### Community Sentiment
- **Consensus**: [what most people agree on]
- **Debates**: [where opinions differ]
- **Warnings**: [common gotchas mentioned]

### Notable Quotes
> "Quote from highly-upvoted comment" - u/username (N upvotes)

### Caveats
- This is anecdotal evidence from community discussions
- Upvotes indicate popularity, not correctness
- Information may be outdated (check post dates)
- [Any other relevant caveats]

### Gaps
- [What you looked for but didn't find]

Rules

  1. Always include URLs - Every finding needs a link
  2. Note upvote counts - Indicates community agreement
  3. Mark as anecdotal - Reddit is not authoritative
  4. Check post dates - Old advice may be outdated
  5. Report gaps - Say what you looked for but didn't find

Gotchas

  1. Search quality is weak - Use specific terms, sort by top
  2. Large threads truncate - Can't expand "more comments" without OAuth
  3. t=hour returns nothing - Use t=year or t=all
  4. Deleted content - [deleted] and [removed] are common
  5. URL encoding - Special characters need encoding (C++ → C%2B%2B)

If Rate Limited

markdown
## Research Brief: [Topic]

**Status**: PARTIALLY COMPLETE - Rate Limited

**Completed Searches**:
- r/rust: [N results]
- r/golang: [N results]

**Recommendation**: Retry in ~2 minutes when rate limit resets.

Writeback

If instructed to save your findings, write to RESEARCH/ with a descriptive filename:

RESEARCH/REDDIT_TOPIC_SLUG_RESEARCH.md

Include your full Research Brief plus the commands you ran.

What You Cannot Do

  • Modify anything - This is a READ ONLY role
  • Present Reddit as authoritative truth
  • Exceed rate limits without backoff
  • Spawn other delegates
  • Make claims without URLs/citations
  • Invent or hallucinate findings

© aaif-goose, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/goosetown-researcher-reddit of aaif-goose/goosetown.

Open the folder on GitHubat commit d1f62b0

Compare with similar skills

Goosetown Researcher Reddit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Goosetown Researcher Reddit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goosetown Researcher Reddit this skillaaif-goose/goosetown155—~1.8kAutomated safety check: PassApache-2.0
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Qiaomu Opencli Usagejoeseesun/qiaomu-opencli-skills993—~3kAutomated safety check: PassMIT
Ray Trend Searchimraywang/rayskills159—~2.1kAutomated safety check: PassCustom licence
Argo Search and Verificationtaxueseek/argo188—~1.2kAutomated safety check: PassMIT

Similar skills

  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Qiaomu Opencli Usage

    joeseesun/qiaomu-opencli-skills

    A skill your agent uses when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv).

    993 GitHub stars~3k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    159 GitHub stars~2.1k tokensUpdated 18 days ago
    Research & ScienceAuto-check passed
  • Unified web search, page fetching and evidence checking across hundreds of sources, with result verification, a research-dossier mode and vertical search engines.

    188 GitHub stars~1.2k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Content Trend Researcher

    alirezarezvani/claude-code-skill-factory

    Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven…

    882 GitHub starsUsed in 1 repo~2.1k tokens
    Writing & ContentAuto-check passed

More from aaif-goose/goosetown

All 12 skills in this repo
  • Goosetown Researcher Arxiv

    aaif-goose/goosetown

    Search arXiv for academic papers, preprints, and research using the arXiv API.

    155 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed
  • Goosetown Researcher Beads

    aaif-goose/goosetown

    Search the local beads (bd) issue tracker for issues, dependencies, epics, blockers, and project status.

    155 GitHub stars~4.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Goosetown Researcher GitHub

    aaif-goose/goosetown

    Search GitHub issues, PRs, code, and discussions using the gh CLI.

    155 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Goosetown Researcher Jira

    aaif-goose/goosetown

    Search Jira issues, sprints, boards, and projects using the Atlassian CLI (acli).

    155 GitHub stars~3.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Goosetown Researcher Local

    aaif-goose/goosetown

    Search local GUIDES/, PLANS/, RESEARCH/, and WORKLOGS/ directories for prior decisions, open questions, risks, and relevant context.

    155 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Goosetown Researcher Slack

    aaif-goose/goosetown

    Search Slack messages, channels, and threads using the Slack MCP extension.

    155 GitHub stars~3.4k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Goosetown Researcher Reddit

What does Goosetown Researcher Reddit do?

Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API. Goosetown Researcher Reddit is an agent skill from aaif-goose/goosetown. Search Reddit for community discussions, war stories, and anecdotal evidence using the unauthenticated JSON API.

How do I install Goosetown Researcher Reddit in Claude Code?

Run `npx skills add aaif-goose/goosetown --skill goosetown-researcher-reddit -a claude-code`. Or copy the skill folder (.claude/skills/goosetown-researcher-reddit in aaif-goose/goosetown) into .claude/skills/goosetown-researcher-reddit in your project. Claude Code loads it when a task matches its description.

How do I install Goosetown Researcher Reddit in Codex?

Run `npx skills add aaif-goose/goosetown --skill goosetown-researcher-reddit -a codex`. Or copy the skill folder (.claude/skills/goosetown-researcher-reddit in aaif-goose/goosetown) into .agents/skills/goosetown-researcher-reddit in your project. Codex loads it when a task matches its description.

Can I use Goosetown Researcher Reddit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aaif-goose/goosetown --skill goosetown-researcher-reddit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/goosetown-researcher-reddit, .gemini/skills/goosetown-researcher-reddit, .github/skills/goosetown-researcher-reddit and .opencode/skills/goosetown-researcher-reddit in your project.

What does Goosetown Researcher Reddit need to run?

Going by SKILL.md and its folder, Goosetown Researcher Reddit needs the command-line tools its instructions call (jq, curl and python3). Our summary lists: Python 3; Docker.

Does Goosetown Researcher Reddit access the network?

SKILL.md names 1 domain. In commands or code: reddit.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Goosetown Researcher Reddit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Goosetown Researcher Reddit use?

Goosetown Researcher Reddit is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Goosetown Researcher Reddit use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Goosetown Researcher Reddit?

Skills that share tags, products or a category with Goosetown Researcher Reddit: Agent Reach (Panniantong/Agent-Reach, 95k stars), Last30days (mvanhorn/last30days-skill, 64k stars), Qiaomu Opencli Usage (joeseesun/qiaomu-opencli-skills, 993 stars) and Ray Trend Search (imraywang/rayskills, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Goosetown Researcher Reddit?

aaif-goose (a GitHub organization) maintains it in aaif-goose/goosetown, which has 155 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 18, 2026.

Source: aaif-goose/goosetown on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.