codebase-inspection

Analyze codebases with pygount to produce language breakdowns, LOC counts, and code-vs-comment ratios.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill codebase-inspection-chris-chai-minjae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill codebase-inspection-chris-chai-minjae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing a codebase to produce an accurate language breakdown, lines of code counts, and the proportion of code to comments, enabling faster codebase understanding and audits.

Core Features & Use Cases

  • Language breakdown and LOC counting using pygount to surface language composition and file counts.
  • Code-vs-comment ratio metrics to assess documentation coverage and maintainability.
  • Use Case: quickly assess a repository's size and complexity before starting refactors or audits.

Quick Start

Run pygount on the target repository to generate a straightforward codebase metrics report.

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 generate a language breakdown for my repository?

To count lines of code and generate a language breakdown, this Skill uses pygount to parse source files, automatically excluding build directories to output structured metrics like file counts and language composition.

Can I calculate code-vs-comment ratios to assess maintainability across multiple repositories?

Yes, you can calculate code-vs-comment ratios across multiple repositories. This Skill supports multi-repo audits, producing metrics that help you quickly assess documentation coverage and maintainability sizing.

What is the best way to measure codebase complexity before starting a refactor?

The best way to measure codebase complexity before refactoring is to analyze language composition and lines of code. This Skill surfaces structured metrics that enable quick sizing and maintainability reviews.

Does the codebase analysis exclude build directories when counting LOC?

Yes, the codebase analysis excludes build directories when counting LOC. By leveraging pygount, it parses source files accurately to ensure generated metrics reflect actual project code.

How do I get structured codebase metrics suitable for dashboards?

You get structured codebase metrics suitable for dashboards by running this Skill. It leverages pygount to produce structured outputs containing LOC counts, language breakdowns, and code-vs-comment ratios.