Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-code
Open on GitHub

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

2Manually: put the files in place

~/.claude/skills/w-api-docs/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-api-docs/

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

Similar skills

All skills for Writing and docs →

From the same set45

The whole set →
w-shadcn The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui. CX Codex +1 647installs w-ui w-ui — a Claude Code skill for building or reshaping user-facing interfaces around a project’s existing tokens and accessible interactions. It checks rendered screens on desktop and mobile. CX Codex +1 647installs w-diagram The w-diagram Claude Code skill turns code, architecture, or data flows into Mermaid diagrams. For product and architecture requests, it compares named MDX or DESIGN.md files with the code. CX Codex +1 647installs w-onboard The w-onboard Claude Code skill takes a developer from cloning a repository to a running local app. It follows project setup instructions and checks that the app can reach its API. CX Codex +1 647installs w-docs w-docs — a skill for Claude Code updates project docs after code or feature changes. It selects the docs layer that owns the change. CX Codex +1 647installs w-architecture The w-architecture Claude Code skill plans an implementation structure against a project's architecture docs and ADRs. It runs on requests to plan a change. CX Codex +1 647installs w-roadmap The w-roadmap Claude Code skill compares implementation with GitHub issues and related docs. Invoke it explicitly to see which items are shipped, partial, or missing. CX Codex +1 647installs w-clarify The w-clarify Claude Code skill finds missing decisions that could block correct work. It checks the request against the project’s code and documentation first. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open