skills.rest
superfhp
superfhpCOMMUNITY
Explore all skills by this author →
GitHub

codebase-inspection

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

Updated May 13, 2026
Search Tags:#codebase analysis#code metrics#pygount#language breakdown#lines of code#repository inspection
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill codebase-inspection-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill codebase-inspection-superfhp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve? Answering questions about repository size, language composition, and code-to-comment ratios requires running line-counting tools correctly, and misconfigured scans of dependency folders can hang or produce misleading numbers. ## Core Features & Use Cases - Language Breakdown: Generate summary tables of files, code lines, and comment lines per programming language using pygount. - Targeted Counting: Filter analysis by file suffix or exclude dependency and build directories like node_modules, venv, and .git. - Flexible Output: Produce summary tables, per-file detail, or JSON output for programmatic consumption. - Use Case: When asked "how big is this repo", run a pygount summary with proper folder exclusions to report total LOC, dominant languages, and comment ratios in seconds. ## 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?▼

Run pygount with the summary format from the repository root to get per-language counts of files, code lines, and comment lines. Always pass --folders-to-skip to exclude .git, node_modules, and virtual environments.

How to count LOC for only one programming language?▼

Use the --suffix flag with pygount to restrict counting to specific file extensions, such as --suffix=py for Python only or --suffix=py,yaml,yml for multiple types. This also speeds up scans on large repositories.

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

Pygount crawls every directory by default, including node_modules, .git, and virtual environments, which can contain millions of files. Add --folders-to-skip with dependency and build directories to avoid this.

Why does Markdown show zero code lines in pygount?▼

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

Can pygount output results as JSON for scripts?▼

Yes, pygount supports --format=json for programmatic consumption alongside the default summary table and per-file detail formats. JSON output is useful when feeding metrics into other tools or pipelines.

Related Skills

Explore More Software Engineering Skills→
gitlabhqgitlabhq
34

related-repositories

Manage a registry of related repositories and clone them via git.

Official
Basic
ribatsheporibatshepo

codebase-stats

Collect codebase metrics and debt indicators across multiple languages.

Community
Advanced
alexica00alexica00

audit-codebase

Audit codebases by scoring seven health categories and generating a prioritized progression plan.

Community
Advanced
lucasfthlucasfth

codebase-inspection

Analyze Git repositories to count LOC, language breakdown, and code-vs-comment ratios.

Community
Intermediate