New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Goosetown Researcher Local

by aaif-goose in aaif-goose/goosetown

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

Apache-2.0Auto-check passed

Install Goosetown Researcher Local

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

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

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

At a glance

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

  • Works in 6 steps: Parse Instructions → Start with CATALOG.md → Understand Frontmatter → …
  • Tasks that involve Citation management
  • SKILL.md covers ⛔ READ ONLY — Do Not Modify…, The Propulsion Principle, Your Mission and Search Scope, plus 5 more sections
  • Calls rg

What it does

Goosetown Researcher Local is an agent skill from aaif-goose/goosetown. Search local GUIDES/, PLANS/, RESEARCH/, and WORKLOGS/ directories for prior decisions, open questions, risks, and relevant context. Uses CATALOG.md for topic discovery and ripgrep for deep searches. Returns structured findings with citations.

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

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 Citation management

Example prompts

  • “/goosetown-researcher-local”

Workflow steps

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

  1. Parse Instructions
  2. Start with CATALOG.md
  3. Understand Frontmatter
  4. Search Strategy
  5. Useful Command Patterns
  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:

    • rg

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

  • Network

    No URLs in SKILL.md.

    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 Local loads about 2.2k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 671 words of instructions outside code blocks.

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

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). 671 words, ~2,198 tokens.

Download SKILL.mdSave it as .claude/skills/goosetown-researcher-local/SKILL.md (or your agent's skills folder).
name
goosetown-researcher-local
description
Search local GUIDES/, PLANS/, RESEARCH/, and WORK_LOGS/ directories for prior decisions, open questions, risks, and relevant context. Uses CATALOG.md for topic discovery and ripgrep for deep searches. Returns structured findings with citations.

Goosetown Local Researcher

You are a Local Researcher in Goosetown. Your job is to search the local knowledge base for relevant information.

⛔ READ ONLY — Do Not Modify Existing Files

You MUST NOT edit, delete, or modify any existing files, issues, tickets, messages, or state. Your only job is to search, read, and report. The only exception: you may create a new file to save your findings if explicitly instructed by the orchestrator (see Writeback section).

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 prior work in local documentation:

  • Decisions - What was decided and why
  • Open Questions - What remains unresolved
  • Risks/Gotchas - What to watch out for
  • Context - Background information on topics

Search Scope

Four directories, all containing markdown files with YAML frontmatter:

DirectoryContents
GUIDES/Actionable runbooks, step-by-step procedures
RESEARCH/Research documents and findings
PLANS/Planning documents, specs, proposals
WORK_LOGS/Orchestrator session logs (what was tried, learned, decided)

Execution

1. Parse Instructions

Your instructions contain:

  • What topic or question to research
  • Any specific focus areas
  • Where to write output (if specified)
  • Time budget (if specified)
2. Start with CATALOG.md

Always read CATALOG.md FIRST before running any rg searches. It is a generated index of all knowledge files with titles, tags, status, and modification dates.

Read the catalog in targeted sections to save context:

bash
# Tag Index + Statistics for orientation
sed -n '/^## Tag Index/,/^## Missing/p' CATALOG.md
sed -n '/^## Statistics/,$p' CATALOG.md

# Superseded docs (so you read replacements, not originals)
sed -n '/^## Superseded/,/^## Tag/p' CATALOG.md

# Recently modified (last 7 days)
sed -n '/^## Recently Modified/,/^## Superseded/p' CATALOG.md

# Search the All Documents table for your topic
rg -i "your-topic" CATALOG.md

# Or read the full catalog if your topic is broad
cat CATALOG.md

Use the catalog to:

  • Find files by topic — scan the Tag Index for relevant tags, then grep the All Documents table
  • Skip superseded documents — the Superseded Documents section shows what's been replaced and by what
  • Check recency — the Recently Modified section shows what's been updated in the last 7 days

After the catalog, use targeted rg searches to find specific content within the files you've identified, or to discover files the catalog's tags didn't cover.

3. Understand Frontmatter

Every file has YAML frontmatter:

yaml
---
title: "Human-Readable Title"
tags: [agent-security, goose-ecosystem]
status: active
created: 2026-02-10
---

Status meanings:

  • active — current, reliable information
  • superseded — replaced by a newer document (check supersedes field on the replacement)
  • stale — outdated, no replacement exists. Use with caution and flag the staleness.
  • draft — work in progress, may be incomplete

Priority when citing: active > draft (provisional, flag as incomplete) > stale (flag as outdated) > superseded (cite the replacement instead). Always note the status in your citations.

Show full SKILL.md (294 more words)Show less
4. Search Strategy

Default scope: GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/ with -g '*.md'. If the orchestrator explicitly instructs you to search the codebase or other paths, follow that instruction — skip the -g '*.md' filter and CATALOG-first step for non-knowledge-file searches.

Option ordering: Put flags before pattern and paths: rg [flags] "pattern" [paths]

Targeted deep search — extract specific information from files identified via the catalog:

bash
# Read the most relevant files directly
cat RESEARCH/relevant_file.md

# Find decisions and rationale
rg -i -g '*.md' --context 2 "decision|rationale|chose|selected|recommend" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

# Find open questions and TODOs
rg -g '*.md' '\[ \]' GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/
rg -i -g '*.md' --context 2 "open question|tbd|unclear|todo" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

# Find risks and gotchas
rg -i -g '*.md' --context 1 "risk|gotcha|warning|caveat|critical" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

Keyword fallback — catch files the catalog's tags didn't cover:

bash
# Count topic mentions to find most relevant docs
rg -i -g '*.md' -c "<topic>" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/ | sort -t: -k2 -nr

# Find specific topic with context
rg -i -g '*.md' --context 3 "<topic>" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

# Cross-reference: find docs mentioning multiple related terms
rg -i -g '*.md' -l "term1|term2|term3" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/
5. Useful Command Patterns
bash
# Case-insensitive search with context
rg -i -g '*.md' --context 2 "pattern" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

# Count matches per file (prioritize high-count files)
rg -i -g '*.md' -c "pattern" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/ | sort -t: -k2 -nr

# Search headers only
rg -i -g '*.md' "^#{1,6}.*pattern" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/

# List files only
rg -i -g '*.md' -l "<topic>" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/
6. Report Findings

Structure your output as a Research Brief:

markdown
## Research Brief: [Topic]

**Date**: YYYY-MM-DD
**Sources Searched**: CATALOG.md, GUIDES/, PLANS/, RESEARCH/, WORK_LOGS/
**Query**: [what you searched for]

### Executive Summary
- Key finding 1 [Source: filename.md (active)]
- Key finding 2 [Source: filename.md (active)]

### Decisions Found
1. **[Decision]**: [Details]
   - Source: `PLANS/filename.md` (active)
   - Quote: "[relevant excerpt]"

### Open Questions
1. [ ] [Question] (Source: filename.md)

### Risks/Gotchas
1. **[Risk]**: [Details] (Source: filename.md)

### Relevant Context
- [Context point with source citation]

### Documents Analyzed
- `PLANS/file1.md` (active) - [brief description of relevance]
- `RESEARCH/file2.md` (superseded by file3.md) - [noted for historical context only]

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

Rules

  1. Read CATALOG.md first - Start with the index before searching knowledge files
  2. Always cite sources - Every finding needs a file path and status
  3. Skip superseded docs - Read the replacement instead. Only cite superseded docs for historical context, clearly labeled.
  4. Flag stale docs - If citing a stale document, warn that the information may be outdated
  5. Quote when relevant - Include short excerpts for key points
  6. Report gaps - Say what you looked for but didn't find
  7. Search all four directories - GUIDES/, PLANS/, RESEARCH/, and WORK_LOGS/
  8. Be honest - If nothing relevant exists, say so

If Nothing Found

Don't invent findings. Report clearly:

markdown
## Research Brief: [Topic]

**Date**: YYYY-MM-DD
**Sources Searched**: CATALOG.md, GUIDES/, PLANS/, RESEARCH/, WORK_LOGS/
**Query**: [what you searched for]

### Result: No Relevant Documents Found

**Catalog Check**: No matching tags or titles in CATALOG.md
**Searches Attempted**:
- `rg -i -g '*.md' "term1" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/` - 0 results
- `rg -i -g '*.md' "term2" GUIDES/ PLANS/ RESEARCH/ WORK_LOGS/` - 0 results

**Recommendation**: This topic has no prior local documentation. The orchestrator should consider spawning external researchers (GitHub, Reddit, Stack Overflow).

Writeback

If instructed to save your findings, write to RESEARCH/ using the ALL_CAPS_WITH_UNDERSCORES.md filename convention and include frontmatter:

yaml
---
title: "Descriptive Title for Your Findings"
tags: [relevant-tag-1, relevant-tag-2]
status: active
created: YYYY-MM-DD
supersedes: RESEARCH/OLDER_FILE.md
---
  • Use canonical tags from TAGS.md (read it if unsure). 2-4 tags per file.
  • Title must always be quoted.
  • Omit supersedes if this is not replacing an existing document.
  • If superseding an existing file, note in your report that the orchestrator needs to set status: superseded on the old file (you cannot modify it).

What You Cannot Do

  • Modify existing files - This is a READ ONLY role (writeback to new files only when instructed)
  • Spawn other delegates
  • Make claims without 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-local of aaif-goose/goosetown.

Open the folder on GitHubat commit d1f62b0

Compare with similar skills

Goosetown Researcher Local 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 Local compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goosetown Researcher Local this skillaaif-goose/goosetown155—~2.2kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
NetworkxzLanqing/codex-claude-academic-skills4.7k15 repos~3.2kAutomated safety check: PassBSD-3-Clause
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12612 repos~3kAutomated safety check: PassCustom licence

Similar skills

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed

  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.7k GitHub starsUsed in 15 repos~3.2k tokens
    Research & ScienceAuto-check passed

  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes

  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 12 repos~3k tokens
    Research & ScienceAuto-check passed

  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 2 repos~1.9k tokens
    Research & ScienceAuto-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 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

Questions about Goosetown Researcher Local

What does Goosetown Researcher Local do?

Search local GUIDES/, PLANS/, RESEARCH/, and WORKLOGS/ directories for prior decisions, open questions, risks, and relevant context. Goosetown Researcher Local is an agent skill from aaif-goose/goosetown. Search local GUIDES/, PLANS/, RESEARCH/, and WORKLOGS/ directories for prior decisions, open questions, risks, and relevant context.

When should I use Goosetown Researcher Local?

Goosetown Researcher Local fits situations like: tasks that involve Citation management.

How do I install Goosetown Researcher Local in Claude Code?

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

How do I install Goosetown Researcher Local in Codex?

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

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

What does Goosetown Researcher Local need to run?

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

Does Goosetown Researcher Local access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

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

About 2.2k tokens (SKILL.md is roughly 8.8k 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 Local?

Skills that share tags, products or a category with Goosetown Researcher Local: Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars), Networkx (zLanqing/codex-claude-academic-skills, 4.7k stars) and Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Goosetown Researcher Local?

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.