codebase-inspection

Inspect codebases with pygount to report lines of code, language breakdown, and code-to-comment ratios.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve? Answering questions about repository size, language composition, and code-versus-comment ratios requires running line-counting tools correctly, and misconfigured scans can hang on dependency directories like node_modules or .git. ## Core Features & Use Cases - Language Breakdown: Produces a summary table of files, code lines, and comment lines per programming language using pygount. - Targeted Counting: Filters analysis to specific file suffixes such as Python or YAML, and supports JSON output for programmatic use. - Safe Scanning Defaults: Provides curated --folders-to-skip exclusion lists for Python, JavaScript, and general projects to avoid crawling dependency trees. - Use Case: When asked "how big is this repo", run the summary command with proper exclusions and report the per-language LOC table with percentages. ## Quick Start Ask the assistant to count the lines of code and show the language breakdown of a repository using pygount with dependency folders excluded.

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 in a repository with pygount?

Run pygount with --format=summary from the repository root to get a per-language table of files, code lines, and comment lines. Always pass --folders-to-skip to exclude .git, node_modules, and virtualenv directories.

How to count only Python files with pygount?

Use the --suffix flag to filter by file extension, for example pygount --suffix=py --format=summary. You can list multiple suffixes such as py,yaml,yml to count several file types at once.

Why does pygount hang or take a long time on my repo?

Pygount crawls every directory by default, including .git, node_modules, and virtualenvs, which can contain hundreds of thousands of files. Add --folders-to-skip with the appropriate exclusion list for your project type to fix this.

Why does pygount show zero code lines for Markdown files?

Pygount classifies all Markdown content as comments rather than code, so Markdown files show zero code lines. This is expected behavior, not a bug in the count.

Can pygount output results as JSON for scripts?

Yes, pygount supports --format=json for programmatic consumption in addition to the default summary table. For accurate raw line counts of JSON files themselves, use wc -l directly since pygount counts JSON conservatively.