codebase-inspection

Inspect codebases with pygount to calculate lines of code and language distribution.

Updated May 11, 2026
One-click install
npx skills add https://github.com/heximao/agents --skill codebase-inspection-heximao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/heximao/agents/tree/main/skill-archive/docker-hermes/github/codebase-inspection
Command: npx skills add https://github.com/heximao/agents --skill codebase-inspection-heximao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount, and includes scripts (resource) components.

What problem does it solve?

This Skill helps analyze your codebase's lines of code, language breakdown, and other metrics, providing insights into its structure and complexity.

Core Features & Use Cases

  • LOC and Language Breakdown: Quickly get a summary of lines of code and language distribution.
  • Codebase Size and Composition: Understand the size and composition of your codebase.
  • Code vs. Comment Ratios: Evaluate the ratio of code to comments, helping to assess code density.
  • Custom Outputs: Use various output formats like summary, JSON, and more, tailored to your needs.
  • Filtering and Sorting: Filter and sort results by language, file, or other criteria.
  • Use Case: If you're looking to optimize your codebase or understand its current state, this Skill can provide valuable insights.

Quick Start

Use the codebase-inspection skill to get a summary of your codebase metrics.

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I calculate lines of code and language breakdown for my project?

To calculate lines of code and language breakdown, this Skill inspects your codebase using pygount, providing metrics on code distribution, size, and complexity across multiple platforms.

How do I get a code vs comment ratio for my codebase?

Getting a code vs comment ratio evaluates code density by inspecting your codebase with pygount, which calculates the exact proportion of comment lines relative to executable code.

Can I export codebase metrics as JSON for programmatic use?

You can export codebase metrics as JSON for programmatic use, as this Skill provides various output formats including JSON and summary views tailored to your analysis needs.

Does pygount codebase analysis work on Windows and macOS?

Pygount codebase analysis works on Windows and macOS, as well as Linux, allowing you to inspect lines of code and language distribution seamlessly across these operating systems.

Do I need to install pygount before analyzing codebase size and composition?

You need to install pygount before analyzing codebase size and composition, because this Skill explicitly utilizes the pygount library as its core dependency to perform the codebase inspection.

How do I filter lines of code results by programming language?

To filter lines of code results by programming language, use the Skill's built-in filtering and sorting capabilities to organize codebase metrics by specific languages, files, or other criteria.