Which documentation platforms are compatible?

It supports a variety of platforms including Docusaurus, MkDocs, GitBook, and Astro Starlight, focusing on Markdown-based static site generation.

Does this skill support API documentation?

Yes, it provides comprehensive patterns for OpenAPI and Swagger specifications to ensure your REST or GraphQL APIs are accurately documented.

How does this skill help with documentation quality?

It promotes automation for link checking, spell checking, and code example validation to maintain high standards across all project documentation.

What is the Docs-as-Code philosophy?

It is an approach where documentation is treated like software, using the same tools as code—including version control (Git), pull requests, and CI/CD automation.

Can I generate diagrams with this skill?

Yes, the skill includes templates and guidance for generating architecture diagrams as code using Mermaid and PlantUML syntax.

Documentation as Code

Name: Documentation as Code
Author: weirdgme

byweirdgme

•

Learning & Documentation

Automates and standardizes technical documentation using Git-based workflows, Markdown templates, and API specifications.

This Claude Code skill implements the Docs-as-Code philosophy by integrating technical writing directly into the software development lifecycle. It provides specialized guidance for creating high-quality READMEs, OpenAPI specifications, and architecture diagrams using tools like Mermaid and PlantUML. By treating documentation like source code—utilizing version control, automated testing, and CI/CD pipelines—it ensures that project guides, API references, and system designs remain accurate, maintainable, and synchronized with the codebase.

Key Features

01Integration patterns for Docusaurus, MkDocs, and other static site generators

02Automated documentation workflows including link checking and linting

03Standardized Markdown templates for READMEs and technical style guides

043 GitHub stars

05Comprehensive OpenAPI and Swagger API documentation support

06Architecture diagram generation using Mermaid and PlantUML code

Use Cases

01Managing API documentation and schema validation alongside backend development

02Generating and maintaining living architecture diagrams within Git repositories

03Setting up professional documentation sites with automated CI/CD deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add weirdgme/claude-code-infrastructure-showcase documentation-as-code

For use in Claude.ai and ChatGPT

Download Skill