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
Installs
6
Repository
lelborn/skills
First Seen
Oct 1, 2026