Skip to main content
skill CX Codex

w-docs — Claude Code skill: docs updates and installation

w-docs — a skill for Claude Code updates project docs after code or feature changes. It selects the docs layer that owns the change.

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-docs -a claude-code
Open on GitHub

What w-docs does

w-docs updates the project documentation layer responsible for a change. For architecture, commands, or workflows, it finds the relevant technical docs section and an existing topic page; it creates a page only when none fits. Canonical explanations go into MDX.

README changes are limited to updates about running, setup, or scripts. Agent rules change only when a constraint changes. The skill follows the repository’s documentation conventions and keeps MDX content out of READMEs and rules. It does not commit unless asked.

For file moves, it proposes a compact from/to list grouped by related files. It saves that list only when given a path, and moves files only when implementation is also requested.

What it helps with

  • update technical docs after an architecture change
  • add a new command to an existing MDX topic page
  • sync the README with changes to setup or scripts
  • revise an agent rule after a constraint changes

Example prompts for the agent

  • Update the docs for this feature in the layer that owns it.
  • Add this command to the existing MDX page and link it from the README.
  • Propose a grouped from/to list for these files, but leave them in place.

How to install w-docs

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a claude-code

2Manually: put the files in place

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

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about w-docs

How do I install w-docs in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a claude-code. The skill file is at ~/.claude/skills/w-docs/SKILL.md.

What does w-docs do?

It updates the docs layer responsible for a code or feature change: technical documentation, the README, or agent rules. It creates an MDX page only when no existing topic page fits.

When does w-docs edit the README or agent rules?

It edits the README for changes to setup, scripts, or how to run the app or package. It edits agent rules when a constraint the agent must follow changes.

Source text

SKILL.md · MIT
---
name: w-docs
description: Document the current code or feature in the owning docs layer.
disable-model-invocation: true
---

Document the current code or feature. Follow the consuming repo's docs and README rules. Do not commit unless asked. Durable information architecture belongs in existing MDX; do not invent a second sitemap.

Write to the layer that owns the change:

| Layer | Role | Update when |
| --- | --- | --- |
| Technical docs (path in `AGENTS.md`) | Architecture, ADRs, how-to | Behavior, architecture, commands, conventions, or workflow changed |
| Agent rules | Short constraints | A convention the agent must not violate changed |
| Nearest README | How to run this app/package; links only | Scripts, setup, or package purpose changed |

Inline comments only when the code is otherwise misleading. Do not copy MDX into rules or READMEs. Do not `@`-attach MDX.

1. Identify the matching docs section, then an existing topic page (create a page only if none fits).
2. Write or patch MDX if the canonical explanation changed.
3. Patch README only for run/setup/scripts; link the MDX.
4. Patch the glob-matched rule only if a constraint changed.
5. For mechanical file or doc moves: propose the smallest from/to list grouped by related files; drop folder-name prefixes inside groups. Save only if the user gave a path. Do not move files unless they also asked to implement.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

All skills for Writing and docs →

From the same set45

The whole set →
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-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. 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 w-deslop The w-deslop Claude Code skill removes AI-generated noise from branch changes compared with main. It checks comments, defensive code, and any casts. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open