Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-code
Open on GitHub

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

2Manually: put the files in place

~/.claude/skills/research-first/SKILL.md

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

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.

research-first ZaxbyHub The research-first skill checks current documentation and discussions before tracing code when an issue depends on an external framework, tool, or platform. For repo-local questions, it searches the repository instead. CX Codex +1 ★ 539repo stars deep-research glebis Runs deep research on any topic through the OpenAI Deep Research API: sharpens the prompt with follow-up questions, saves the parameters, returns a report with sources. CX Codex +1 331installs research-planning lingzhi227 research-planning is a Claude Code skill that builds research plans with methodology, dependencies, paper structure and UML diagrams. It runs for new projects or paper reproduction. CX Codex +1 1,800installs bmad-research aj-geddes bmad-research — a skill that conducts structured market, competitor, technology and domain research from live sources, producing a cited research report. Run it before product planning or architecture decisions. CX Codex +1 138installs rpi-research microsoft The rpi-research skill investigates a task and saves dated findings to a report. Use it when you need evidence and alternatives before planning work. CX Codex +1 ★ 1,627repo stars ppt-image-first-workflow reason-machines ppt-image-first-workflow takes a vague deck request through style previews and a locked plan to a PPTX where every slide is one full-page image made with GPT Image 2. CX Codex +1 332installs research SuperClaude-Org research — a command for investigating complex questions beyond your knowledge cutoff. It breaks down the task automatically, runs parallel searches, and collects evidence with source attribution. CX Codex +1 ★ 23,950repo stars

From the same set121

The whole set →

Project sponsors

Companies that keep this analytics open