Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add benbrastmckie/nvim --skill skill-researcher -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/skill-researcher/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-researcher/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open