codebase-inspection

Count lines of code, language distribution, and code-vs-comment ratios using pygount.

174|23|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/RedWoodOG/Hermes-Desktop --skill codebase-inspection-redwoodog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/RedWoodOG/Hermes-Desktop/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/RedWoodOG/Hermes-Desktop --skill codebase-inspection-redwoodog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly quantify codebases by counting lines of code, breaking down languages, and measuring code-vs-comment ratios to inform refactoring and auditing.

Core Features & Use Cases

  • LOC & language breakdown: Get totals by language with file counts and lines of code and comments.
  • Codebase sizing and health checks: Assess repository size and composition to guide optimization.
  • Use Case: When planning a refactor, run this to understand language distribution and hotspots across the repo.

Quick Start

Run pygount on the target repository with sensible folder exclusions to obtain a complete LOC, language, and comment ratio 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 analyze language distribution in a repository?

To count lines of code and analyze language distribution, this Skill uses pygount to scan your repository, providing totals by language, file counts, and lines of code and comments. It applies sensible folder exclusions to deliver a complete LOC and language composition report for project planning or audits.

What is a code-vs-comment ratio and when do I need it for refactoring?

A code-vs-comment ratio measures the proportion of actual code lines to comments within a file. You need this metric during refactoring to assess codebase health, identify under-documented complex sections, and guide optimization efforts across the repository.

Do I need pygount installed to get LOC metrics and file-type breakdowns?

Yes, you need pygount installed to get LOC metrics and file-type breakdowns. This Skill requires the pygount package to execute its codebase analysis, count lines of code, and output the developer-friendly structured report for your repository.

Can I use this codebase analysis on any repository size?

Yes, you can use this codebase analysis on any repository size. The Skill is applicable to projects of all scales, accurately quantifying codebases by breaking down languages and measuring code-vs-comment ratios to inform your refactoring and auditing tasks.

What's the best way to perform a codebase sizing and health check?

The best way to perform a codebase sizing and health check is running a pygount-based analysis that assesses repository size and composition. This approach quantifies total lines of code, language distribution, and comment ratios to effectively guide optimization and audits.