codebase-inspection

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

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/tangzheng202202/hermes-skills --skill codebase-inspection-tangzheng202202
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/tangzheng202202/hermes-skills/tree/main/01-coding-dev/github/codebase-inspection
Command: npx skills add https://github.com/tangzheng202202/hermes-skills --skill codebase-inspection-tangzheng202202

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes codebases to deliver reliable metrics such as lines of code (LOC), language distribution, and code-vs-comment ratios, enabling quick assessments of repository size and code health.

Core Features & Use Cases

  • LOC & Language Breakdown: Generate a precise breakdown of languages and file counts, plus total code and comment lines.
  • Code-Base Health Metrics: Compute code-vs-comment ratios to help gauge maintainability.
  • Use Case: When asked to size up a repository, quickly produce a summary of languages, LOC, and comments to guide audits or refactors.

Quick Start

Run a targeted analysis on a repository using pygount to obtain LOC, language distribution, and code-comment ratios.

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

To count lines of code and get a language breakdown for your repository, you can analyze the codebase to produce precise LOC counts, language distributions, and file counts using pygount.

What is a code-vs-comment ratio and how does it indicate codebase health?

A code-vs-comment ratio measures the proportion of comment lines to executable code lines. Computing this ratio helps gauge repository maintainability and baseline code-quality by revealing documentation coverage.

Do I need pygount to analyze repository metrics and language distribution?

Yes, you need pygount installed to analyze repository metrics and language distribution. It is a required dependency for generating precise LOC counts and code-vs-comment ratios from your codebase.

Can I use codebase analysis for sizing up a repository before a refactor?

Yes, you can use codebase analysis for sizing up a repository before a refactor. It quickly produces a summary of languages, LOC, and comments to guide audits and refactoring decisions.

What's the best way to generate structured outputs for codebase LOC metrics?

The best way to generate structured outputs for codebase LOC metrics is applying a targeted analysis to the repository, which validates results and structures the language breakdown and code counts for immediate use.