w-api-docs — Claude Code skill for API docs
The w-api-docs Claude Code skill refreshes API documentation from its source schema or routes. It steps in when an API change needs to be reflected in generated docs.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-codeWhat w-api-docs does
w-api-docs updates API documentation from the owning schema or routes instead of editing generated files by hand. It starts by reading the API MDX and generator README, then locating the source and generation script in package.json.
Changes go into the schema or route, followed by the repository’s documented generation command. Drift-check scripts should run too if the repository has them. Generated OpenAPI files, clients, and SQL are not edited directly.
Adopter MDX changes only when API behavior changes. The skill must not invent authentication, rate-limit, or versioning rules. If behavior or commands changed, documentation can also be updated with /w-docs.
What it helps with
- refresh API docs after changing a schema or route
- regenerate OpenAPI from its source definition
- check generated files for drift
- sync adopter MDX with changed API behavior
Example prompts for the agent
- Update the API docs after I change a Fastify route, then run the generator from
package.json. - Change the TypeBox schema and regenerate OpenAPI without editing generated files.
- Bring the adopter MDX up to date with the changed API behavior.
How to install w-api-docs
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-code2Manually: put the files in place
~/.claude/skills/w-api-docs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-api-docs/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a codex2Manually: put the files in place
.agents/skills/w-api-docs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a cursor2Manually: put the files in place
.cursor/skills/w-api-docs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-api-docs2Manually: put the files in place
.github/skills/w-api-docs/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-api-docsManually: put the files in place
.devin/skills/w-api-docs/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -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 w-api-docs
How do I install w-api-docs in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-code, then install the skill at ~/.claude/skills/w-api-docs/SKILL.md.
What does w-api-docs do?
It updates API documentation from the schema or routes that own the API definition, then runs the documented generator command. It does not directly edit generated OpenAPI files, clients, or SQL.
Which files does w-api-docs change?
It changes the source schema or route. Adopter MDX is updated only when behavior changes; generated artifacts are not edited directly.
Source text
SKILL.md · MIT
--- name: w-api-docs description: Refresh API docs from the owning schema source; never edit generated OpenAPI by hand. disable-model-invocation: true --- Update API documentation from the source of truth (TypeBox/Fastify routes, or the repo's documented generator). Never edit generated OpenAPI, generated clients, or generated SQL directly. 1. Read the API docs MDX and the generator README. Identify the owning source and the generate script in package.json. 2. Change the owning schema or route, not the generated artifact. 3. Run the documented generate command. Check drift scripts if the repo has them. 4. Update adopter MDX only for behavior that changed. Do not invent auth, rate-limit, or versioning policy. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills