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;
  • .md files are parsed as CommonMark and .mdx files as MDX, so a bare <placeholder> in a .md page 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 by pnpm start and never by a build;
  • the navbar shows a version badge from DOCS_VERSION, or else from git describe on the newest vX.Y.Z tag, and no badge when neither exists;
  • the site URL and base path come from DOCS_URL and DOCS_BASE_URL, defaulting to http://localhost:3000 and /, 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.
Installs
2
GitHub Stars
3
First Seen
13 days ago