research-first · zaxbyhub — Claude Code skill: what it does, how to install
research-first forces agents to verify repo facts and external sources before planning or writing code.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-codeWhat research-first does
This skill establishes a strict pre-planning investigation step. It prevents an agent from drafting implementation steps while critical unknowns remain unresolved or unlisted as risks.
Under this protocol, external information requires consulting primary references and linking source URLs. For repository internals, the agent relies on rg, direct file inspection, and test runs rather than memory. Verified findings remain strictly separated from working assumptions.
Tasks involving OpenAI tools require official documentation alongside the openai-docs skill.
What it helps with
- verify external library behavior before drafting an implementation plan
- inspect repository code using
rgand test suites instead of guessing - isolate confirmed technical facts from unverified assumptions
- review release notes and security advisories prior to task execution
Example prompts for the agent
- Check the release notes and external docs before planning the integration
- Inspect the repository with rg and run tests to verify module behavior
- Resolve all unknowns about this third-party API and cite official sources
How to install research-first
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-code2Manually: put the files in place
~/.claude/skills/research-first/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/research-first/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a codex2Manually: put the files in place
.agents/skills/research-first/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a cursor2Manually: put the files in place
.cursor/skills/research-first/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .agents/skills/research-first2Manually: put the files in place
.github/skills/research-first/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/research-firstManually: put the files in place
.devin/skills/research-first/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -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 research-first
How to install research-first in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-code in your terminal.
What does the research-first skill do?
It mandates thorough discovery across docs and repository code before any planning or coding begins.
Which sources does it use for OpenAI tasks?
Whenever OpenAI tooling is involved, it requires primary official documentation and the openai-docs skill.
Source text
SKILL.md · MIT
--- name: research-first description: Codex adapter for research-before-planning work. Use when a task depends on current external facts, unfamiliar libraries, APIs, standards, security advisories, release notes, product behavior, or repo behavior that must be verified before planning or implementation. metadata: audience: swarm-plugin --- # Research First Read `.claude/skills/research-first/SKILL.md` for the source protocol. Codex-specific execution notes: - For current or unstable external facts, browse or use primary sources and cite URLs. - For repo facts, prefer `rg`, file reads, tests, and local source over memory. - Separate verified facts from assumptions. - Do not plan implementation until the relevant unknowns are resolved or explicitly marked as risks. When research affects OpenAI product usage, use the `openai-docs` skill and official sources only.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Agent setup: memory, context, orchestration →research-first by other authors comes first.