Generate a Docusaurus documentation site from ADRs and OpenSpec specs.
npx skills add https://github.com/joestump/claude-plugin-design --skill docs-joestump
Please help me install this Agent Skill. Skill: docs Source: https://github.com/joestump/claude-plugin-design/tree/main/skills/docs Command: npx skills add https://github.com/joestump/claude-plugin-design --skill docs-joestump
This skill automates generation and maintenance of a Docusaurus documentation site from ADRs and OpenSpec specs, eliminating manual transforms, cross-references, and upgrade bookkeeping.
Run the docs skill to scaffold or integrate a Docusaurus docs site from your repository's ADRs and OpenSpec specs.
High-intent search queries and answers about installing and using this skill.
To generate a Docusaurus site from ADRs and OpenSpec specs, run the docs skill to trigger transform scripts that convert your markdown into MDX with auto-generated sidebars, requirement boxes, and cross-reference links, writing a .design-docs.json manifest for tracking.
You can integrate architecture documentation into an existing Docusaurus project non-destructively. The skill uses a .design-docs.json manifest with sha256 checksums to manage template upgrades while preserving your site customizations during sync workflows.
The required directory structure for converting ADRs and OpenSpec specs to MDX expects ADRs stored in docs/adrs and OpenSpec specs stored in docs/openspec/specs within your repository. The skill detects these paths to automate the transformation process.
Yes, you need Node.js installed to scaffold a Docusaurus documentation site from ADRs. The skill performs pre-flight checks for Node.js before detecting or copying templates and running transform scripts to produce the MDX output.
Upgrade tracking for a generated Docusaurus site works by creating and maintaining a .design-docs.json manifest with sha256 checksums. This allows the skill to detect template changes during upgrades while safely preserving your local customizations.
When transforming OpenSpec specs to MDX, the skill applies formatting features including RFC 2119 highlighting, requirement boxes, status badges, cross-reference links, and auto-generated sidebars to produce a living architecture documentation site.
joestumpList ADRs and specs with status and dates from YAML frontmatter.
brandonjjonDeploy applications and infrastructure to Cloudflare Workers and Pages.
smoregGenerate bilingual YouTube titles, descriptions, and upload commands for audiobook videos.
Logos-LiberCompare static site generators and documentation platforms for technical documentation workflows.
