codebase-inspection

Run pygount to compute lines of code and language breakdowns.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/eddielueng/hermes-agent-zh --skill codebase-inspection-eddielueng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/eddielueng/hermes-agent-zh/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/eddielueng/hermes-agent-zh --skill codebase-inspection-eddielueng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand how large a codebase is and how its content is distributed by language, including the balance between code and comments.

Core Features & Use Cases

  • LOC and composition reporting: Produces lines-of-code style metrics and language breakdowns to answer “how big is it?” and “what’s it made of?”
  • Code vs. comment ratio: Quantifies executable/declarative code lines versus comment/documentation lines for readability and maintainability signals.
  • Actionable repo stats: Supports both high-level summaries and deeper per-file breakdowns for audits, refactors, and planning.

Quick Start

Ask to inspect a repository’s lines of code, language breakdown, and code-vs-comment ratio, and the skill will run pygount with appropriate folder exclusions (like .git and node_modules) to avoid slow or hanging scans.

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I count lines of code and get a language breakdown for a repository?▼

To count lines of code and get a language breakdown, the tool runs pygount with robust folder exclusions like .git and node_modules. It computes per-file and summary metrics including code, comment counts, and percentages for engineering planning.

What is a code vs comment ratio and why measure it in a codebase?▼

A code vs comment ratio quantifies executable lines versus documentation lines to signal readability and maintainability. Measuring it in a codebase helps audit documentation density and estimate effort for refactors across large software projects.

Can I audit repository size and composition for large software projects?▼

Yes, you can audit repository size and composition for large software projects. The tool generates high-level summaries and deeper per-file breakdowns of lines of code and language distribution to support audits and planning.

How do I avoid slow or hanging scans when counting lines of code?▼

To avoid slow or hanging scans when counting lines of code, the tool automatically applies robust folder exclusion parameters for directories like .git and node_modules. This ensures the codebase scan completes quickly without getting stuck.

Does pygount support per-file output for code and comment counts?▼

Yes, pygount supports per-file output for code and comment counts. The tool provides detailed per-file breakdowns including code, comment counts, and percentages, alongside high-level summaries for actionable repository statistics.