docs-first

A portable Agent Skill that forces an AI coding agent to consult official documentation before answering questions about specific third-party software — even when it feels confident.

Training data has a cutoff. The dangerous case isn't "I don't know" — it's "I'm confident I know" while the library moved on six months ago.

Original skill by itoldis on ClawHub.

What it does

When you ask "how do I do X in <library>", "what's the flag for Y", "does Z support W", or paste an error from a specific tool, the agent will search the official docs / repo first and ground its answer in what it reads, ending with a small checkable source link.

Install

This skill follows the open Agent Skills standard (SKILL.md) and works across Claude Code, Cursor, OpenAI Codex, Gemini CLI, OpenClaw, and other compatible agents.

Cursor / Claude Code / Codex / Gemini (from this repo)

Copy the docs-first/ folder into your skills directory:

# Cursor (global)
cp -r docs-first ~/.cursor/skills/

# Claude Code (global)
cp -r docs-first ~/.claude/skills/

# Codex (global)
cp -r docs-first ~/.codex/skills/

# project-local (any of the above agents)
cp -r docs-first .cursor/skills/

OpenClaw / ClawHub

openclaw skills install docs-first

Claude Code marketplace

claude plugin marketplace add itoldis/docs-first-skill
claude plugin install docs-first

Layout

docs-first-skill/
├── SKILL.md                            # the skill (universal Agent Skills format)
├── README.md                          # this file
├── .clawhub.yml                       # ClawHub publish metadata
├── .claude-plugin/
│   └── marketplace.json               # Claude Code marketplace catalog
└── plugins/docs-first/
    ├── .claude-plugin/plugin.json
    └── skills/docs-first/SKILL.md

License

MIT-0 — see the frontmatter in SKILL.md.