What documentation types does Doc Style Guard support?

It supports a wide range of types including API specifications, UI/UX notes, operational settings, decision records (ADR), and project-level metadata like AGENTS.md.

Can I use it for projects not using Domain-Driven Design?

Yes. While the structure is optimized for DDD, the templates and consistency checks for technical specifications and operational logs are beneficial for any software project.

Does it integrate with my Git workflow?

Yes, the skill includes procedures to identify changed files using git status or list_changes.sh before applying the style and granularity checks.

How does it enforce documentation style?

It utilizes a comprehensive checklist that monitors for conciseness, specific bulleting formats, the exclusion of emojis, and the inclusion of mandatory sections like scope and constraints.

Where are the documentation templates located?

Templates are stored in references/templates.md and cover everything from data schemas and architecture to roll-back procedures and testing perspectives.

DDD Doc Style Guard

Name: DDD Doc Style Guard
Author: shoichiro-suzuki

byshoichiro-suzuki

0•

Content Management

Standardizes the style, structure, and granularity of project documentation using Domain-Driven Design principles.

Doc Style Guard is a specialized Claude Code skill designed to maintain consistency across project documentation, specifically for Domain-Driven Design (DDD) projects. It provides automated checklists and templates for various document types—including API specifications, UI notes, and operational guides—ensuring that critical files like AGENTS.md and CLAUDE.md remain concise, structured, and easy to navigate. By enforcing specific formatting rules and providing a clear 'Definition of Done' for technical writing, it helps development teams eliminate documentation rot and fragmented information throughout the software lifecycle.

Key Features

01Automated style checklists for conciseness and technical clarity

02Enforcement of DDD-aligned documentation granularity

03Standardized templates for API specs, UI plans, and operational logs

04Integrated workflow for verifying documentation updates via git status

05Management of core project metadata files like AGENTS.md and CLAUDE.md

060 GitHub stars

Use Cases

01Auditing project documentation for conciseness and proper cross-referencing

02Standardizing API and functional specifications to ensure consistent input/output documentation

03Maintaining a uniform structure for decision logs and architectural records

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shoichiro-suzuki/ip-support-app doc-style-guard

For use in Claude.ai and ChatGPT

Download Skill