ai-scaffold-docusaurus-site
Installation
SKILL.md
/ai-scaffold-docusaurus-site — A Docusaurus Site Around a Docs Tree
This skill stands up a Docusaurus 3 site in the repository it is run in: the site's build files, and
the empty content directories the chosen layout needs, each seeded with a README.md index page. It
writes no content page. Filing and writing pages is left to the project.
Every site it writes carries the same fixed configuration, whatever the interview's answers:
- a broken link or a broken anchor fails the build;
.mdfiles are parsed as CommonMark and.mdxfiles as MDX, so a bare<placeholder>in a.mdpage does not break the build;- pages are served from the site root, with no
/docs/prefix; - a
working/directory under the content root is rendered bypnpm startand never by a build; - the navbar shows a version badge from
DOCS_VERSION, or else fromgit describeon the newestvX.Y.Ztag, and no badge when neither exists; - the site URL and base path come from
DOCS_URLandDOCS_BASE_URL, defaulting tohttp://localhost:3000and/, so the skill writes no host at all; - each top-level content directory gets its own sidebar and navbar item, derived from the tree at build time, so adding an audience or a section later is a directory, not a configuration edit.