codebase-inspection

Analyze codebases with pygount for lines of code and language breakdown.

1|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/icyzh/hermes-web --skill codebase-inspection-icyzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/icyzh/hermes-web/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/icyzh/hermes-web --skill codebase-inspection-icyzh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve?

This skill eliminates the guesswork involved in understanding a project's scale by providing precise metrics on lines of code, language distribution, and documentation density.

Core Features & Use Cases

  • Language Breakdown: Automatically identifies and categorizes files by programming language.
  • Metric Analysis: Calculates code-vs-comment ratios to assess documentation quality.
  • Use Case: Use this when onboarding to a new repository to quickly identify the primary languages used and the overall complexity of the codebase.

Quick Start

Run the codebase inspection skill on the current directory to generate a summary of all programming languages and their respective line counts.

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 a repository?

To calculate lines of code and language breakdown for a repository, you can use this skill to analyze software directories and generate precise metrics on code distribution and documentation density.

What is the best way to analyze code-to-comment ratios in a codebase?

Analyzing code-to-comment ratios in a codebase involves calculating documentation density against actual source lines. This skill assesses documentation quality by generating these ratio metrics automatically during the repository audit.

Do I need pygount installed to analyze codebase metrics?

Yes, you need the pygount Python package installed in your environment to perform accurate file-by-file codebase metrics. The skill relies on this utility to calculate lines of code and language breakdown.

Can I audit a large-scale codebase while filtering out dependency directories?

Yes, you can audit large-scale codebases while filtering out dependency directories and build artifacts. This skill supports large-scale repository auditing by excluding these folders to ensure accurate codebase metrics.

How does codebase size analysis help with onboarding to a new repository?

Codebase size analysis helps with onboarding to a new repository by quickly identifying the primary programming languages used and assessing the overall complexity of the codebase through lines of code and documentation metrics.

What are the limitations of using pygount for code analysis?

A limitation of using pygount for code analysis is its basic implementation depth, focusing strictly on file-by-file metrics like lines of code and language breakdown rather than providing deep structural or complexity analysis.