codebase-inspection

Inspect codebases with pygount to count lines of code and analyze language composition.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill codebase-inspection-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill codebase-inspection-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve? Answering questions about repository size, language breakdown, and code-vs-comment ratios requires running the right analysis commands with correct exclusions, which is easy to get wrong on large repos. ## Core Features & Use Cases - LOC Counting: Count lines of code, comments, and files per language using pygount summary output. - Language Filtering: Restrict analysis to specific file suffixes such as py, yaml, or yml. - Safe Exclusions: Skip .git, node_modules, venv, and build directories to avoid hangs on large dependency trees. - Use Case: When asked "how big is this repo", run pygount with a summary format and folder exclusions to produce a per-language table of files, code lines, and comment lines. ## Quick Start Use the codebase-inspection skill to analyze this repository and report its lines of code and language breakdown.

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 --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 venv directories.

How to count LOC for only one programming language?

Use the --suffix flag with pygount 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.

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. Always pass --folders-to-skip with dependency and build directories to keep scans fast.

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 an error in the analysis.

Does pygount count JSON files accurately?

Pygount may count JSON lines conservatively, producing lower code counts than expected. For precise JSON line counts, use wc -l directly on the files instead.