skills.rest
perasyudha
perasyudhaCOMMUNITY
Explore all skills by this author →
Website𝕏@Nyxora_AIGitHub

codebase-inspection

Analyze repository lines of code, language breakdown, and comment ratios using pygount.

5|2|Updated May 26, 2026
Search Tags:#repository#codebase analysis#code metrics#loc#pygount#language breakdown#lines of code
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill codebase-inspection-perasyudha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/github/codebase-inspection
Command: npx skills add https://github.com/perasyudha/Nyxora --skill codebase-inspection-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve? Answering questions about repository size, language composition, and code-to-comment ratios normally requires manual counting or ad-hoc scripts. This Skill provides ready-to-use pygount commands that produce accurate codebase metrics without crawling dependency folders or hanging on large trees. ## Core Features & Use Cases - Language Breakdown: Generate a summary table of files, code lines, and comment lines per programming language. - Targeted Counting: Filter analysis by file suffix (e.g., only Python or YAML) and exclude directories like node_modules, .git, and venv. - Multiple Output Formats: Produce summary tables, per-file detail, or JSON for programmatic consumption. - Use Case: A developer evaluating a legacy monorepo asks how large it is and which languages dominate; the Skill runs pygount with proper exclusions and returns a clean per-language metrics table. ## Quick Start Ask the agent to count the lines of code and show the language breakdown of the current repository using pygount.

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 in 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 virtual environments.

How to count only specific languages like Python with pygount?▼

Use the --suffix flag to filter by file extension, for example --suffix=py for Python only or --suffix=py,yaml,yml for multiple types. This limits the scan to matching files and speeds up analysis.

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. Always pass --folders-to-skip with dependency and build directories to avoid 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 counting.

Can pygount output results as JSON for scripts?▼

Yes, use --format=json to get machine-readable output suitable for programmatic processing. The default summary format is better for human-readable tables, and per-file detail is available with the default format.

Related Skills

Explore More Software Engineering Skills→
jakubbartnikjakubbartnik

codebase-inspection

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

Community
Basic
Veloxia-agencyVeloxia-agency

cto-advisor

Assess technical leadership decisions and engineering risk for CTO-level planning.

Community
Advanced
mhattingpetemhattingpete
657

code-auditor

Audit codebases for architecture, quality, security, performance, testing, and maintainability issues.

Community
Advanced
matthew-johnsonmatthew-johnson

codebase-inspection

Analyze repositories with pygount to quantify LOC, language distribution, and code-vs-comment ratios.

Community
Intermediate