gen

Overview ¶

Command gen generates internal/skill/content/references/*.md from docs/commands.md. Run via `make skill-bundle` (which wraps `go run ./internal/skill/gen`), or directly with `-out <dir>` to generate into a scratch directory for drift checking (see `make skill-validate`).

docs/commands.md documents some patterns once across several commands (the asset CRUD list/get/create/update/delete pattern; query-command mechanics like filter syntax) rather than once per command, so this generator can't just mechanically split the doc by heading. Instead each topic below names exactly which sections/labels it draws from — a hand-maintained map that must gain an entry whenever a new command or asset kind is added (see docs/adding-commands.md).