codebase-inspection

Analyze repositories with pygount to calculate lines of code and language distribution.

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

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 identify the programming languages present in a repository and their respective file counts.
  • Code-vs-Comment Ratios: Calculate the density of documentation versus executable code to assess project maintainability.
  • Use Case: Quickly evaluate the complexity of a new open-source project or audit a legacy codebase to determine the effort required for a refactoring task.

Quick Start

Use the codebase-inspection skill to generate a summary report of the current directory while excluding dependency folders.

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 distribution for a software repository?

To calculate lines of code and language distribution for a software repository, use this skill to perform static analysis on source files. It processes directory structures to generate a summary report of your codebase's composition.

Can I measure code-to-comment ratios to assess project maintainability?

Yes, you can measure code-to-comment ratios to assess project maintainability. The skill calculates the density of documentation versus executable code, helping you evaluate documentation density across various programming languages.

Do I need pygount installed to analyze codebase size and composition?

Yes, you need the pygount package installed in your environment to analyze codebase size and composition. The skill requires this utility to perform static analysis and calculate project metrics.

What's the best way to audit a legacy codebase and exclude dependency folders?

The best way to audit a legacy codebase and exclude dependency folders is to run this skill on your current directory. It automatically generates a summary report while filtering out dependency folders.

Does this code analysis tool work with multiple programming languages?

Yes, this code analysis tool works with multiple programming languages. It automatically identifies the languages present in your repository and counts their respective files for project size estimation.

When should I use a lines of code counter for project size estimation?

You should use a lines of code counter for project size estimation when you need to evaluate the complexity of a new open-source project or determine the effort required for a refactoring task.