docs-health

Audit CLAUDE.md and SKILL.md files for byte size and line counts.

2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/air-gapped/cooked --skill docs-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-health
Source: https://github.com/air-gapped/cooked/tree/main/.claude/skills/docs-health
Command: npx skills add https://github.com/air-gapped/cooked --skill docs-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks CLAUDE.md and every skill's SKILL.md to ensure documentation stays within size limits and maintains clear line counts, promoting readability and maintainability.

Core Features & Use Cases

  • Size & Line Count Auditing: Measures byte size and line counts for CLAUDE.md and SKILL.md files to flag oversized docs.
  • Guidance & Refactoring: Suggests consolidation or movement of content when limits are exceeded.
  • Use Case: A team re-evaluates documentation to keep CLAUDE.md under recommended thresholds while keeping skills concise and actionable.

Quick Start

Run: wc -c CLAUDE.md; wc -l CLAUDE.md; wc -c .claude/skills//SKILL.md 2>/dev/null; wc -l .claude/skills//SKILL.md 2>/dev/null

Frequently Asked Questions about docs-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check CLAUDE.md and SKILL.md file sizes and line counts?

Check documentation health by measuring byte sizes and line counts of CLAUDE.md and SKILL.md files using allowed Bash tools, then receiving concise reports on whether they exceed recommended thresholds.

Why does my CLAUDE.md documentation health check flag oversized files?

Documentation health checks flag oversized CLAUDE.md files when byte sizes or line counts exceed recommended thresholds, indicating the content needs consolidation or details moved elsewhere to maintain readability.

What is the best way to keep skill docs lean and consistent?

Keep skill docs lean by auditing SKILL.md files for size and line-count metrics, then refactoring or moving detailed content out when the documentation exceeds recommended complexity ranges.

How do I measure byte size and line count metrics for skill documentation?

Measure byte size and line count metrics for skill documentation by executing standard Bash tools such as `wc -c` and `wc -l` against CLAUDE.md and .claude/skills/*/SKILL.md paths to generate parseable results.

When should I consolidate or move details out of my CLAUDE.md files?

Consolidate or move details out of CLAUDE.md files when size and line-count metrics exceed recommended thresholds, as flagged by a documentation health check, to ensure the file remains actionable.