codebase-inspection

Counts lines of code and language composition in repositories using pygount-based scanning with folder exclusions and JSON output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly understand how large a repository is and how its content is distributed across languages, file types, and comment-heavy sections, without manually counting files or lines.

Core Features & Use Cases

  • LOC and file counts: Summarize repository size with lines of code, comment lines, and file counts by language.
  • Language composition: Reveal which languages dominate a project and how much each contributes to the overall codebase.
  • Codebase audits: Use it for repo health checks, monorepo profiling, and quick comparisons between projects.
  • Practical example: A maintainer can inspect a new repository before onboarding to estimate complexity and identify the main implementation languages.

Quick Start

Ask the skill to analyze the repository and return a pygount summary with language breakdown, LOC, and code-versus-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 analyze language breakdown in a repository?

To count lines of code and analyze language breakdown, scan the repository using pygount to summarize file counts, code versus comment ratios, and language composition. This returns a summary of the codebase size and its distribution across different programming languages.

What is the best way to measure codebase size for a monorepo audit?

The best way to measure codebase size for a monorepo audit is applying pygount-based scanning with folder exclusions. This profiles the monorepo to reveal its total lines of code, file counts, and language mix without manually counting files.

Can I get JSON output for repository metrics when scanning a source tree?

Yes, you can get JSON output for repository metrics when scanning a source tree. The scanning process supports summary, JSON, or suffix-filtered output formats to capture repository metrics including lines of code and comment ratios.

How does codebase analysis handle comment ratios and folder exclusions?

Codebase analysis handles comment ratios by calculating code lines versus comment lines per language using pygount. It applies folder exclusions during the scan to skip irrelevant directories, ensuring the repository metrics accurately reflect the source tree.

Do I need pygount installed to analyze lines of code in my project?

Yes, you need pygount for analyzing lines of code in your project, as the scanning relies on pygount-based logic to count code and comment lines. This dependency is required to perform the codebase analysis and generate the language breakdown.