codebase-inspection

Measure LOC, language distribution, and code-vs-comment ratios with pygount.

1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill codebase-inspection-changzhou-xj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/ChangZhou-xj/zxj_skill/tree/main/github/codebase-inspection
Command: npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill codebase-inspection-changzhou-xj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often need a quick, reliable snapshot of a codebase's size and language composition. This Skill provides automated LOC, language distribution, and code-vs-comment ratios using pygount to accelerate assessments and planning.

Core Features & Use Cases

  • Language breakdown with file counts and code vs. comment metrics.
  • Repository sizing and language balance insights for refactoring or onboarding.
  • Use Case: Evaluate a monorepo to identify dominant languages and problematic directories for optimization.

Quick Start

Run pygount on the target repository to generate a language breakdown and LOC report.

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I analyze a codebase for language distribution and LOC metrics?

To analyze a codebase for language distribution and LOC metrics, you can run pygount on the target repository to automatically measure lines of code, identify dominant languages, and calculate code-vs-comment ratios for a structured summary report.

What is the best way to get a code vs comment ratio for a software repository?

The best way to get a code vs comment ratio for a software repository is to use an analysis tool like pygount, which scans standard repository structures to automatically calculate and report the density of comments relative to actual code.

Can I use pygount to evaluate a monorepo and identify heavy directories?

Yes, you can use pygount to evaluate a monorepo by scanning its structure to surface hotspots like heavy directories or nested monorepos, providing file counts and language balance insights suitable for optimization and audits.

Does codebase LOC analysis work with repositories of varying sizes?

Codebase LOC analysis works with software repositories of varying sizes, using standard repository structures to assess language balance, compare file counts, and measure code density without requiring specific scale limitations.

What do I need to generate a codebase metrics report for onboarding or refactoring?

To generate a codebase metrics report for onboarding or refactoring, you need a standard repository structure and the pygount dependency, which together produce a structured summary of repository sizing and language breakdown insights.