How does strict mode work?

In strict mode, the skill treats files containing only placeholder text as failures rather than warnings, ensuring higher documentation quality.

Can I use this for different types of projects?

Yes, it supports specific validation rules for core services, libraries, and applications to match different structural needs.

Can I run this in my CI pipeline?

Yes, by using the --json flag, the skill produces machine-readable output that can be parsed by automated testing and deployment workflows.

What does the validate skill do?

It checks your project's documentation folders and files against a predefined standard to ensure nothing is missing or left as a placeholder.

Does it validate the actual content of the files?

It focuses on structural integrity and identifying placeholder text, ensuring the required documentation architecture exists even if it doesn't perform deep linguistic analysis.

Documentation Structure Validator

Name: Documentation Structure Validator
Author: alexnodeland

byalexnodeland

•

콘텐츠 관리

Validates documentation structure and content compliance across software modules against standardized templates.

The Documentation Structure Validator is a specialized skill for Claude Code that ensures project documentation remains consistent, complete, and compliant with specification-driven development standards. It audits modules for mandatory directories, files, and architectural records while identifying incomplete placeholder content that might otherwise go unnoticed. Supporting various module types—including core services, libraries, and applications—this skill helps maintain high-quality technical documentation throughout the development lifecycle, offering both human-readable reports and machine-readable JSON for automated workflows.

주요 기능

01Verifies presence of mandatory documentation directories such as proposals, plans, and decisions

02Provides machine-readable JSON output for seamless integration into CI/CD pipelines

03Identifies and flags placeholder-only content to prevent incomplete documentation

04Offers repo-level root validation to ensure global documentation standards are met

05Supports specialized validation rules for different module types including core, lib, and app

063 GitHub stars

사용 사례

01Post-scaffolding audits to ensure all required documentation stubs were created correctly

02Continuous integration checks to enforce documentation standards across complex monorepos

03Pre-merge reviews to verify that architectural decisions and runbooks are present for new features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled validate

For use in Claude.ai and ChatGPT

Download Skill