check-sizes

Check source file sizes against CLAUDE.md limits and report violations.

6|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/opmau/claude-code-framework --skill check-sizes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-sizes
Source: https://github.com/opmau/claude-code-framework/tree/main/templates/.claude/skills/check-sizes
Command: npx skills add https://github.com/opmau/claude-code-framework --skill check-sizes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Large source files can bloat context windows and hinder automated reviews. This skill automatically checks all source files against the size limits defined in CLAUDE.md to keep codebases within expected limits.

Core Features & Use Cases

  • Read per-language and per-module size limits from CLAUDE.md.
  • Count lines in headers and implementation files, and compute total per module.
  • Generate a report with counts for within limits, over limits, and approaching limits, plus suggested splitting strategies.

Quick Start

Run the check-sizes skill on your project directory to audit all source files against CLAUDE.md limits.

Frequently Asked Questions about check-sizes

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

FAQPage Schema
How do I check source file sizes against CLAUDE.md limits?

You can check source file sizes by running an audit on your project directory that evaluates header, implementation, and total line counts against CLAUDE.md thresholds, generating a report of within-limit, over-limit, and approaching-limit files.

Why do large source files bloat context windows during automated code reviews?

Large source files bloat context windows by exceeding token capacity, which hinders automated reviews. Enforcing CLAUDE.md file size limits keeps codebases within expected limits and prevents context window exhaustion.

How do I enforce per-module and per-language file size limits?

Enforce per-module and per-language file size limits by reading thresholds from CLAUDE.md, counting lines in headers and implementation files, computing totals per module, and flagging files that exceed these defined limits.

Can I get splitting strategies for files approaching size limits?

Yes, the size audit report includes suggested splitting strategies for files approaching size limits, alongside categorized counts of files that are within limits, over limits, or approaching limits.

What is the best way to audit codebase files for context management limits?

The best way to audit codebase files for context management limits is to run an automated check that evaluates all source files against CLAUDE.md size thresholds, categorizing results into within-limit, over-limit, and approaching-limit groups.

Do I need a CLAUDE.md file to check codebase size limits?

Yes, you need a CLAUDE.md file to check codebase size limits. The audit reads per-language and per-module size thresholds directly from CLAUDE.md to evaluate source files and flag violations.