Agent skill

Goosetown Researcher GitHub

by aaif-goose in aaif-goose/goosetown

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

Apache-2.0Auto-check passedBackend & APIs

Install Goosetown Researcher GitHub

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

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

GitHub CLI
$ gh skill install aaif-goose/goosetown goosetown-researcher-github --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-github .claude/skills/goosetown-researcher-github && 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-github
GitHub stars
155
Token cost
~1.6k tokens
SKILL.md length
389 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 6 steps: Parse Instructions → Check Rate Limits First → Search Commands → …
  • Tasks that involve Rate limiting
  • SKILL.md covers ⛔ READ ONLY — You Must Not…, The Propulsion Principle, Your Mission and Execution, plus 4 more sections
  • Calls gh; reaches github.com

What it does

Goosetown Researcher GitHub is an agent skill from aaif-goose/goosetown. Search GitHub issues, PRs, code, and discussions using the gh CLI. Finds prior decisions, implementation patterns, and maintainer discussions. Returns structured findings with links and citations.

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

It sits in Backend & APIs, covering Rate limiting and Citation management. It works with GitHub. The repository describes itself as: Steampunk geese run a parallel processing commune. Surprisingly effective. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Rate limiting
  • Tasks that involve Citation management

Example prompts

  • “/goosetown-researcher-github”

Workflow steps

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

  1. Parse Instructions
  2. Check Rate Limits First
  3. Search Commands
  4. Rate Limit Handling
  5. Signal Ranking
  6. 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:

    • gh

    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:

    • github.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 GitHub loads about 1.6k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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). 389 words, ~1,621 tokens.

Download SKILL.mdSave it as .claude/skills/goosetown-researcher-github/SKILL.md (or your agent's skills folder).
name
goosetown-researcher-github
description
Search GitHub issues, PRs, code, and discussions using the gh CLI. Finds prior decisions, implementation patterns, and maintainer discussions. Returns structured findings with links and citations.

Goosetown GitHub Researcher

You are a GitHub Researcher in Goosetown. Your job is to search GitHub for relevant issues, PRs, code, and discussions.

⛔ READ ONLY — You Must Not Modify Anything

This is a READ ONLY role. You MUST NOT create, edit, delete, or modify any files, issues, PRs, 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 information on GitHub:

  • Issues - Bug reports, feature requests, discussions
  • PRs - Implementation decisions, code changes, reviews
  • Code - Implementation patterns, examples
  • Discussions - Maintainer rationale, community input

Execution

1. Parse Instructions

Your instructions contain:

  • What topic or question to research
  • Which repos to search (e.g., block/goose)
  • Any specific focus (issues only, PRs only, etc.)
  • Where to write output (if specified)
2. Check Rate Limits First
bash
gh api rate_limit --jq '.resources.search'
# Returns: {"limit":30,"remaining":N,"reset":TIMESTAMP,"used":N}

If remaining is low, pace your searches carefully.

3. Search Commands

Search Issues

bash
# Open issues with keyword
gh search issues "topic" --repo owner/repo --state open --limit 20 \
  --json number,title,labels,author,createdAt,url

# Closed issues (often have solutions)
gh search issues "topic" --repo owner/repo --state closed --limit 20 \
  --json number,title,labels,closedAt,url

# Issues by label
gh search issues --repo owner/repo --label "bug" --state open --limit 20 \
  --json number,title,labels,createdAt,url

# Recent issues
gh search issues --repo owner/repo --created ">=2026-01-01" --limit 20 \
  --json number,title,state,createdAt,url

Search PRs

bash
# Merged PRs (highest signal - decisions implemented)
gh search prs "topic" --repo owner/repo --merged --limit 20 \
  --json number,title,author,closedAt,url

# Open PRs
gh search prs --repo owner/repo --state open --limit 20 \
  --json number,title,author,createdAt,url

# PRs by author
gh search prs --repo owner/repo --author username --limit 20 \
  --json number,title,state,createdAt,url

Search Code

bash
# Code containing pattern
gh search code "pattern" --repo owner/repo --limit 20 \
  --json path,repository,textMatches

# Code in specific language
gh search code "async fn" --repo owner/repo --language rust --limit 20 \
  --json path,textMatches

# Code in specific path (use query syntax, not --path flag)
gh search code "config path:src/" --repo owner/repo --limit 20 \
  --json path,textMatches

Note: gh search code does NOT have a --path flag. Use query syntax instead: "query path:dir/"

Search Discussions (GraphQL required)

bash
gh api graphql -f query='
{
  search(query: "repo:owner/repo topic", type: DISCUSSION, first: 10) {
    nodes {
      ... on Discussion {
        number
        title
        url
        createdAt
        category { name }
        author { login }
      }
    }
  }
}'

Get Detailed Info

bash
# Full issue with comments
gh issue view 123 --repo owner/repo \
  --json number,title,body,labels,state,author,createdAt,comments

# Full PR with reviews
gh pr view 456 --repo owner/repo \
  --json number,title,body,state,author,mergedAt,reviews,comments,files
4. Rate Limit Handling

Implement exponential backoff (doubling):

bash
# If rate limited, wait and retry
# Retry 1: 2s, Retry 2: 4s, Retry 3: 8s, Retry 4: 16s, Retry 5: 32s

Rate Limits:

  • Search API: 30 requests/minute (strict)
  • Core API: 5000 requests/hour
  • GraphQL: 5000 points/hour
Show full SKILL.md (151 more words)Show less
5. Signal Ranking

Prioritize findings by signal quality:

  1. Merged PRs - Decisions that were implemented
  2. Maintainer comments - Authoritative explanations
  3. Closed issues with solutions - Problems that were solved
  4. Discussions - Rationale and context
  5. Open issues - Current problems (lower signal)
6. Report Findings

Structure your output as a Research Brief:

markdown
## Research Brief: [Topic]

**Date**: YYYY-MM-DD
**Repos Searched**: owner/repo
**Query**: [what you searched for]

### Executive Summary
- Key finding 1 [Source: #123]
- Key finding 2 [Source: PR #456]

### Relevant Issues
1. **#123: [Title]** (state)
   - URL: https://github.com/...
   - Summary: [brief description]
   - Key quote: "[relevant excerpt]"

### Relevant PRs
1. **PR #456: [Title]** (merged YYYY-MM-DD)
   - URL: https://github.com/...
   - Summary: [what it changed and why]
   - Files: [key files modified]

### Code Patterns Found
1. **`path/to/file.rs`**
   - Pattern: [what you found]
   - Snippet: `[code excerpt]`

### Discussions
1. **Discussion #789: [Title]**
   - URL: https://github.com/...
   - Summary: [key points]

### Recommendations
- [What to do based on findings]

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

Rules

  1. Always include URLs - Every finding needs a link
  2. Check rate limits - Don't exhaust the quota
  3. Prioritize merged PRs - Highest signal source
  4. Report gaps - Say what you looked for but didn't find
  5. Be honest - If nothing relevant exists, say so

If Rate Limited

markdown
## Research Brief: [Topic]

**Status**: PARTIALLY COMPLETE - Rate Limited

**Completed Searches**:
- Issues: [N results]
- PRs: [N results]

**Skipped Due to Rate Limit**:
- Code search
- Discussions

**Recommendation**: Retry in [N] minutes when rate limit resets.

Writeback

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

RESEARCH/GITHUB_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
  • 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-github of aaif-goose/goosetown.

Open the folder on GitHubat commit d1f62b0

Compare with similar skills

Goosetown Researcher GitHub 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 GitHub compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goosetown Researcher GitHub this skillaaif-goose/goosetown155—~1.6kAutomated safety check: PassApache-2.0
Repo2skillzhangyanxs/repo2skill246—~3.6kAutomated safety check: PassNone
Better Auth Security Best PracticesEpicenterHQ/epicenter4.8k—~896Automated safety check: PassCustom licence
Dload Fetch Toolphp-internal/dload105—~1.1kAutomated safety check: PassBSD-3-Clause
Apikerhodgef/apiker127—~1.4kAutomated safety check: PassMIT
Implementing API Key Security Controlsmukul975/Anthropic-Cybersecurity-Skills34k—~4kAutomated safety check: PassApache-2.0

Similar skills

  • Repo2skill

    zhangyanxs/repo2skill

    Convert GitHub/GitLab/Gitee repositories into comprehensive OpenCode Skills using embedded LLM calls with multiple mirrors and rate limit handling

    246 GitHub stars~3.6k tokensUpdated 7 mo ago
    Backend & APIsAuto-check passed
  • Better Auth security hardening: rate limits, secrets, CSRF, trusted origins, cookies, sessions, OAuth tokens, and audit logging.

    4.8k GitHub stars~896 tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Dload Fetch Tool

    php-internal/dload

    Get a CLI tool — native binary or PHAR — from a GitHub release into a project folder with dload (vendor/bin/dload).

    105 GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Apiker

    hodgef/apiker

    Develop, review, and extend the Apiker library — a framework for building serverless REST APIs on Cloudflare Workers + Durable Objects.

    127 GitHub stars~1.4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Implementing API Key Security Controls

    mukul975/Anthropic-Cybersecurity-Skills

    Implements secure API key generation with sufficient entropy, server-side hashing (SHA-256/bcrypt) instead of plaintext storage, per-key scoping to endpoints/IPs/rate limits, zero-downtime rotation…

    34k GitHub stars~4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Handle Issues

    aaddrick/claude-pipeline

    Batch process GitHub issues via batch-orchestrator.sh with rate limit handling and session resumption

    130 GitHub stars~4k tokensUpdated 7 mo ago
    Backend & APIsAuto-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 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 Reddit

    aaif-goose/goosetown

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

    155 GitHub stars~1.8k 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 GitHub

What does Goosetown Researcher GitHub do?

Search GitHub issues, PRs, code, and discussions using the gh CLI. Goosetown Researcher GitHub is an agent skill from aaif-goose/goosetown. Search GitHub issues, PRs, code, and discussions using the gh CLI.

When should I use Goosetown Researcher GitHub?

Goosetown Researcher GitHub fits situations like: tasks that involve Rate limiting; tasks that involve Citation management.

How do I install Goosetown Researcher GitHub in Claude Code?

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

How do I install Goosetown Researcher GitHub in Codex?

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

Can I use Goosetown Researcher GitHub 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-github -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-github, .gemini/skills/goosetown-researcher-github, .github/skills/goosetown-researcher-github and .opencode/skills/goosetown-researcher-github in your project.

What does Goosetown Researcher GitHub need to run?

Going by SKILL.md and its folder, Goosetown Researcher GitHub needs the command-line tools its instructions call (gh).

Does Goosetown Researcher GitHub access the network?

SKILL.md names 1 domain. In commands or code: github.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 GitHub 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 GitHub use?

Goosetown Researcher GitHub 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 GitHub use?

About 1.6k tokens (SKILL.md is roughly 6.5k 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 GitHub?

Skills that share tags, products or a category with Goosetown Researcher GitHub: Repo2skill (zhangyanxs/repo2skill, 246 stars), Better Auth Security Best Practices (EpicenterHQ/epicenter, 4.8k stars), Dload Fetch Tool (php-internal/dload, 105 stars) and Apiker (hodgef/apiker, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Goosetown Researcher GitHub?

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.