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

0•

Learning & Documentation

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

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

01Freshness analysis to detect and update stale documentation

02Standardized checklists for CLAUDE.md and repository structures

03Automated coverage metrics for skills, agents, and commands

04Detailed JSON reporting with doc scores and specific gap analysis

05Accuracy validation to ensure documentation matches code reality

060 GitHub stars

Use Cases

01Maintaining 100% documentation accuracy during rapid development cycles

02Identifying missing documentation for newly added agents or skills

03Performing a pre-release audit of a new PopKit plugin's documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-assessment-documentation

For use in Claude.ai and ChatGPT

Download Skill