codebase-inspection

Analyze codebases for lines of code, language distribution, and code-to-comment ratios.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a fast and easy way to analyze codebases, giving you insights into lines of code, language breakdown, and code-to-comment ratios.

Core Features & Use Cases

  • Lines of Code (LOC) Count: Get a quick overview of the total lines of code in a repository.
  • Language Breakdown: View the distribution of programming languages used in a codebase.
  • Code-to-Comment Ratio: Determine the ratio of code to comments, which can indicate the level of documentation.
  • Use Case: When you need to understand the size and composition of a codebase quickly for project planning or assessment.

Quick Start

To get a summary report of a codebase located at '/path/to/repo', run the following command:

cd /path/to/repo
pygount --format=summary .

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I analyze lines of code and language breakdown in a repository?

To analyze lines of code and language breakdown, run pygount with the summary format option in your repository directory. This generates a report showing total lines of code, language distribution, and code-to-comment ratios for project assessment.

What is a code-to-comment ratio and how is it calculated?

A code-to-comment ratio indicates the level of documentation by comparing comment lines to executable lines. This Skill calculates the ratio using pygount to help developers and project managers assess documentation coverage within a codebase.

Does pygount support analyzing codebases with multiple programming languages?

Yes, pygount supports analyzing multi-language codebases to provide a language breakdown. It identifies the distribution of programming languages used across the repository, allowing you to view the composition of mixed-language projects.

What's the best way to get a quick overview of codebase size and complexity?

The best way to quickly assess codebase size and complexity is running pygount's summary format. It outputs total lines of code, language distribution, and code-to-comment ratios, providing immediate insights for project planning.

Can I use this codebase analysis for project planning and assessment?

Yes, you can use this codebase analysis for project planning and assessment. It provides metrics on lines of code, language breakdown, and code-to-comment ratios, which are suitable for developers and project managers evaluating project scope.

Are there limitations to using pygount for codebase metrics?

Pygount provides basic codebase metrics like lines of code, language distribution, and code-to-comment ratios. It offers a quick overview for assessing code size and complexity, but does not perform deep structural analysis or identify code quality issues.