docs-init
Installation
SKILL.md
docs-init
Lay down the skeleton of a project's documentation and the convention the rest of the docs will follow. The goal isn't to write every page — it's to establish a navigable structure (an index that links everything, one home per unit, source links, cross-links) so that doc-it can fill it in and doc-check can police it. The canonical templates are in references/templates.md.
Docs live under .docs/ (a dotfolder, alongside .github/, .agents/, and friends), not docs/.
The shape
.docs/
├── README.md # the index — one linking table per category
├── project-layout.md # repo tree, naming conventions, dev/build/test commands
├── <ops-doc>.md # only the ops docs that apply, flat at the root (e.g. configuration.md)
├── <kind>/ # one subfolder per KIND of unit, named for that kind…
│ └── <unit-id>.md # …one kebab-case file per unit
└── <kind>/
└── <unit-id>.md