create-doc
Installation
SKILL.md
Create a new documentation file in .chalk/docs/.
Workflow
- Parse the request — Identify the target vertical and topic from
$ARGUMENTS. - Check existing docs — Read filenames in the target directory to find the highest numbered file. The next doc number is
highest + 1. - Draft the doc — Write substantive content, not stubs. Use the structure and tone guidelines below.
- Write the file — Save to
.chalk/docs/<vertical>/<number>_<slug>.md. - Confirm — Tell the user the doc was created with its path and a brief summary.
Verticals
| Vertical | Directory | Use For |
|---|---|---|
| Product | product/ |
Vision, strategy, user research, pricing, competitive analysis |
| AI | ai/ |
Agent context, codebase orientation, prompt patterns, gotchas |
| Engineering | engineering/ |
Architecture, conventions, APIs, runbooks, data flows |
| Root | .chalk/docs/ |
Docs that don't fit a vertical |