codebase-inspection

Compute LOC, language distribution, file counts, and code-vs-comment ratios with pygount.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers and teams quickly quantify and understand a codebase by producing metrics on lines of code, language distribution, and code-vs-comment ratios using pygount.

Core Features & Use Cases

  • Automated Metrics: Generate an at-a-glance breakdown of languages, file counts, and code vs. comments across a repository.
  • Guided Exclusions: Recommend or apply folder exclusions to skip heavy directories like .git, node_modules, and virtual environments.
  • Use Case: Useful for repo audits, onboarding new contributors, or planning refactors in multi-language projects.

Quick Start

Inspect a repository to generate a complete LOC, language breakdown, and size metrics.

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

Yes, you can analyze monorepos and multi-language codebases. The Skill computes per-language file counts and code-to-comment ratios across the entire project, producing a breakdown that helps assess the size, composition, and language mix of complex repositories.

How do I exclude node_modules and virtual environment folders when scanning a codebase?▼

The code-vs-comment ratio is calculated using pygount to distinguish source lines from comment lines across different programming languages. This metric helps developers understand documentation density and code composition during audits or refactoring planning.

Does this codebase inspection tool require any specific dependencies to run?▼

The codebase inspection tool relies on pygount as its primary dependency for analyzing source code metrics. No additional components or external libraries are required, making it straightforward to run on any standard development environment with a cloned repository.

Why generate a LOC and language breakdown report for an existing repository?▼

Generating a LOC and language breakdown report quantifies the codebase to support repo audits, new contributor onboarding, and refactor planning. It provides an at-a-glance view of language distribution and code-vs-comment ratios to help teams understand project composition quickly.