magus-skilldocs

Overview ¶

Command magus-skilldocs generates the agent-skill reference: one page per embedded skill showing both curated permutations, plus an index.

go run ./cmd/magus-skilldocs -out ./docs/reference/skills

The pages are generated from the same embedded bodies `magus agent install` writes, so a skill edit cannot leave the documentation describing a version nobody installs. That is the whole reason this is a generator and not a hand-written page: the alternative is a copy that silently rots, which is the failure this repo builds generators to avoid.

The rendered skill text is fenced verbatim so a reader can copy it, but the page says plainly that `magus agent install` is the supported way to get it - a copied skill carries no provenance stamp, so `magus doctor` cannot tell whether it is current.