What documentation files does this skill check?

It primarily validates CLAUDE.md, SKILL.md, AGENT.md, and command-level documentation for structural integrity and completion.

Can it be used in CI/CD pipelines?

Yes, the skill utilizes Python scripts that can be integrated into automated workflows to enforce documentation standards before merging code.

Does it automatically fix the documentation?

It identifies gaps and provides specific check IDs like CM-001 or SKD-001, allowing developers or Claude to systematically fill in missing information.

How is the doc_score calculated?

The score is a weighted calculation of coverage (percent documented), accuracy (matching reality), and freshness (recency of updates).

PopKit Documentation Assessment

Name: PopKit Documentation Assessment
Author: jrc1883

byjrc1883

Learning & Documentation

Audits and validates documentation quality for Claude Code plugins using automated metrics and standardized checklists.

About

The PopKit Documentation Assessment skill provides a rigorous framework for maintaining high-quality project documentation within Claude Code environments. It automates the measurement of documentation coverage, validates accuracy against actual code, and analyzes freshness to prevent stale content. By combining automated script execution with comprehensive checklists for CLAUDE.md, SKILL.md, and AGENT.md files, it ensures that every component of a plugin is documented according to strict architectural standards and ready for production use, providing developers with actionable reports on gaps and accuracy.

Key Features

Freshness analysis to detect and update stale documentation
Standardized checklists for CLAUDE.md and repository structures
Automated coverage metrics for skills, agents, and commands
Detailed JSON reporting with doc scores and specific gap analysis
Accuracy validation to ensure documentation matches code reality
0 GitHub stars

Use Cases

Maintaining 100% documentation accuracy during rapid development cycles
Identifying missing documentation for newly added agents or skills
Performing a pre-release audit of a new PopKit plugin's documentation

About

Key Features

Freshness analysis to detect and update stale documentation
Standardized checklists for CLAUDE.md and repository structures
Automated coverage metrics for skills, agents, and commands
Detailed JSON reporting with doc scores and specific gap analysis
Accuracy validation to ensure documentation matches code reality
0 GitHub stars

Use Cases

Maintaining 100% documentation accuracy during rapid development cycles
Identifying missing documentation for newly added agents or skills
Performing a pre-release audit of a new PopKit plugin's documentation