skills.rest
vivekgoquest
vivekgoquestCOMMUNITY
Explore all skills by this author →
GitHub

codebase-inspection

Inspect repositories with pygount to count lines of code, languages, and comment ratios.

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

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 the right counting tool with the right exclusions, which is easy to get wrong on large projects. ## 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 by file suffix (e.g., Python, YAML) and supports JSON output for programmatic use. - Safe Defaults: Excludes .git, node_modules, venv, and build directories to prevent hangs on dependency trees. - Use Case: When asked "how big is this repo", run a pygount summary with folder exclusions to report total LOC, dominant languages, and comment ratios in seconds. ## Quick Start Ask the agent to count the lines of code and show the language breakdown for the repository at a given path.

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 file counts, code lines, and comment lines. Always pass --folders-to-skip to exclude .git, node_modules, and virtualenv directories.

How to count LOC for only one programming language?▼

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

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 millions of files. Add --folders-to-skip with dependency and build directories to keep scans fast.

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.

Can pygount output results as JSON for scripts?▼

Yes, pygount supports --format=json for programmatic consumption alongside the default summary table and per-file detailed output. JSON output can be piped into other tools for further processing.

Related Skills

Explore More Software Engineering Skills→
richardnguyen0715richardnguyen0715

codebase-inspection

Analyzes codebases for lines of code, language distribution, and code-to-comment ratios using pygount.

Community
Basic
Veloxia-agencyVeloxia-agency

cto-advisor

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

Community
Advanced
quanganh208quanganh208

ck:retro

Collect git metrics and generate structured retrospective reports in markdown or HTML.

Community
Advanced
eugenereugener
3

codebase-stats

Generate a read-only project analytics dashboard from codebase metrics.

Community
Intermediate