skill-researcher — Claude Code skill: what it does, how to install
skill-researcher is a Claude Code skill that delegates research across the web, docs and codebase to the general-research-agent subagent, then updates task status, links the artifact and commits.
no license 1 installs ★ 445 updated 2026-10-14
npx skills add benbrastmckie/nvim --skill skill-researcher -a claude-codeWhat skill-researcher does
The skill does little research by itself. It hands the job to the general-research-agent subagent, which searches the web, reads docs and walks the codebase with Glob, Grep, WebSearch and WebFetch. What the wrapper adds is the bookkeeping: once the subagent answers, it updates the task status, links the artifact and commits, so the orchestrator is not left hanging on a continue prompt.
A run starts by looking up task_number in specs/state.json. Status moves to researching through .opencode/scripts/update-task-status.sh, and a .postflight-pending marker lands in the task folder. Memories are pulled with memory-retrieve.sh unless --clean is passed. For tasks sitting in implementing or partial, earlier summaries, handoffs, progress files and the latest plan get folded into the prompt.
It fires on general, meta, markdown, latex and typst tasks. You need jq plus the bash helpers under .opencode/scripts/; when active_projects holds no entry with the requested project_number, validation stops the run at stage one.
What it helps with
- gather material for a task before writing the implementation plan
- pull docs and code examples into a single research report
- keep task status in sync while work moves to a subagent
- carry earlier summaries and handoffs into a fresh session
- commit research artifacts together with the status update
Example prompts for the agent
- Run skill-researcher on task 12, focus on how the config parser works
- Research task 7 with
--clean, skip the project memory - Write the report for task 3 and link the artifact to it
How to install skill-researcher
1Skills CLI (Vercel)
npx skills add benbrastmckie/nvim --skill skill-researcher -a claude-code2Manually: put the files in place
~/.claude/skills/skill-researcher/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-researcher/
1Skills CLI (Vercel)
npx skills add benbrastmckie/nvim --skill skill-researcher -a codex2Manually: put the files in place
.agents/skills/skill-researcher/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add benbrastmckie/nvim --skill skill-researcher -a cursor2Manually: put the files in place
.cursor/skills/skill-researcher/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install benbrastmckie/nvim .opencode/skills/skill-researcher2Manually: put the files in place
.github/skills/skill-researcher/SKILL.md1Skills CLI (Vercel)
npx skills add benbrastmckie/nvim --skill skill-researcher -a gemini-cli2Platform CLI
gemini skills install https://github.com/benbrastmckie/nvim --path .opencode/skills/skill-researcherManually: put the files in place
.devin/skills/skill-researcher/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add benbrastmckie/nvim --skill skill-researcher -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-researcher
How do I install skill-researcher in Claude Code?
Run npx skills add benbrastmckie/nvim --skill skill-researcher -a claude-code. The skill file then sits at ~/.claude/skills/skill-researcher/SKILL.md.
What does skill-researcher do?
It delegates research to the general-research-agent subagent, which searches the web, reads documentation and inspects the project code. On return the skill updates the task status, links the artifact and commits the changes itself.
What does it need to run?
jq, the scripts under .opencode/scripts/, and a specs/state.json file with the task listed in active_projects. Without that entry the first validation step aborts the run.