Can I use my own linting rules with this skill?

Yes, it utilizes standard tools like markdownlint and Vale, which typically respect local configuration files within your repository for custom style and grammar rules.

Does it require a specific format for ADRs and PRDs?

It is optimized for standard formats like MADR for ADRs and the Blueprint methodology for PRDs, but it can be adapted to various markdown-based documentation structures.

What specific documentation files does this skill analyze?

It checks CLAUDE.md, Architecture Decision Records (ADRs), Product Requirements Documents (PRDs), Product Requirement Prompts (PRPs), and internal project rules in the .claude/rules/ directory.

How does the freshness analysis work?

The skill compares the 'modified' date in the YAML frontmatter of your documents against the actual git commit history to identify files that haven't been reviewed or updated recently.

Documentation Quality Checker

Name: Documentation Quality Checker
Author: laurigates

bylaurigates

•

学习与文档

Analyzes and validates codebase documentation including CLAUDE.md, ADRs, and PRDs to ensure structural integrity and content freshness.

The Documentation Quality Checker is a specialized skill for Claude Code designed to automate the auditing of project documentation and metadata. It systematically evaluates critical project files—including CLAUDE.md, Architecture Decision Records (ADRs), and Product Requirements Documents (PRDs)—against industry best practices and specific project rules. By integrating tools like markdownlint and Vale, and cross-referencing documentation frontmatter with git commit history, this skill identifies stale content, missing sections, and structural gaps. It produces a comprehensive quality report with actionable recommendations, helping maintain a high-standard, AI-friendly codebase environment.

主要功能

01Freshness analysis comparing documentation 'modified' dates with actual git history

02Multi-dimensional quality scoring system for structure, completeness, and clarity

03Automated structural validation for ADRs, PRDs, and PRPs using standard templates

0410 GitHub stars

05Generation of detailed inventory reports and prioritized remediation checklists

06Built-in linting support via markdownlint and Vale for professional prose quality

使用场景

01Conducting documentation audits during project handovers or onboarding new developers

02Ensuring architectural decisions are properly recorded and indexed in ADR format

03Maintaining documentation hygiene in fast-moving repositories to prevent stale project rules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins docs-quality-check

For use in Claude.ai and ChatGPT

Download Skill