docs-skill-builder
Docs Skill Builder
Use this skill to create documentation skills that match the hindsight-docs generation/install shape: scripts/generate-docs-skill.sh generates skills/<skill-name>/SKILL.md and skills/<skill-name>/references/.
Generated documentation files are mirrored verbatim from the selected upstream
repository paths. Do not rewrite .mdx to .md, normalize links, strip
frontmatter, or otherwise transform source documentation when the operator asks
for a full local reference copy.
Exception: source files named SKILL.md under mirrored documentation are copied
verbatim but stored as SKILL.source.md inside references/. This preserves the
documentation content and hash while preventing Codex/agent recursive discovery
from treating documentation examples as installed skills.
Default behavior is repo/latest. If the operator gives a repository or tool name, fetch the current default branch from the official repository and mirror the latest docs. Do not use a stale local checkout, pinned commit, package version, or previously downloaded copy unless the operator explicitly asks for offline/pinned mode.
For arbitrary repositories, the only intended difference from Hindsight is a required mapping step before generation. Hindsight has a known docs tree; other tools do not. Inspect the latest repo tree, identify the real docs/site/API/example paths, then pass those paths explicitly to the scaffold.