Can I use this with an existing Docusaurus site?

Yes, the skill features an Integration Mode that adds a sync plugin and custom components to your existing Docusaurus setup without overwriting your core configuration.

What documentation formats are supported?

The skill specifically targets Architecture Decision Records (ADRs) and OpenSpec specifications, converting them into interactive MDX files with specialized React components.

How does it handle updates to the documentation site?

It uses a manifest file (.design-docs.json) to track managed files and checksums, allowing it to safely upgrade templates while identifying and flagging user modifications for manual review.

Does the generated site support dark mode?

Yes, all generated components, badges, and keyword highlights include full support for Docusaurus's native dark mode and responsive design.

What happens if I haven't created any ADRs or specs yet?

The skill includes pre-flight checks that will prompt you to create content using the associated design skills before attempting to generate the documentation site.

Architecture & Specification Docs

Name: Architecture & Specification Docs
Author: joestump

byjoestump

•

Learning & Documentation

Generates polished Docusaurus documentation sites automatically from Architecture Decision Records (ADRs) and OpenSpec specifications.

This skill streamlines the creation of technical documentation by transforming markdown ADRs and OpenSpec requirements into a feature-rich Docusaurus website. It handles complex documentation needs like RFC 2119 keyword highlighting, automated cross-referencing between decisions and specs, and status badge generation, ensuring your system architecture remains transparent and navigable. Whether scaffolding a brand-new documentation portal or integrating into an existing Docusaurus setup, it provides a robust, upgradeable framework for maintaining architectural integrity through manifest-based file tracking.

Key Features

014 GitHub stars

02Dark mode support and auto-generated sidebars for all technical docs

03RFC 2119 keyword highlighting (MUST, SHALL, MAY) and requirement boxes

04Smart upgrade tracking via manifest-based file management and checksums

05Automated Docusaurus site scaffolding and integration modes

06Automated cross-reference linking for ADRs and OpenSpec requirements

Use Cases

01Maintaining a synchronized documentation site that updates as architecture evolves

02Generating public-facing technical specifications and API standards

03Publishing internal architecture decision records for engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design docs

For use in Claude.ai and ChatGPT

Download Skill