codebase-inspection

npx skills add HezaoHezao/poirot --skill codebase-inspection --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Codebase Inspection Analyze repositories for lines of code, language breakdown, file counts, and code-vs-comment ratios using `pygount`. ## When to Use - User asks for LOC (lines of code) count - User wants a language breakdown of a repo - User asks about codebase size or composition - User wants code-vs-comment ratios - General "how big is this repo" questions ## Prerequisites ```bash pip install pygount ``` ## 1. Basic Summary (Most Common) ```bash cd /path/to/repo pygount --format=summary \ --folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,.eggs,*.egg-info" \ . ``` **IMPORTANT:** Always use `--folders-to-skip` to exclude dependency/build directories, otherwise pygount will crawl them and take a very long time. ## 2. Common Folder Exclusions ```bash # Python project --folders-to-skip=".git,__pycache__,venv,.venv,.tox,.eggs,*.egg-info,.pytest_cache,.mypy_cache,.ruff_cache" # Node.js project --folders-to-skip=".git,node_modules,dist,build,.next,.cache,coverage" # General (safe default) --folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.tox,.eggs,*.egg-info,.pytest_cache,.mypy_cache" ``` ## 3. Detailed Per-File Out

pip install pygount
cd /path/to/repo
pygount --format=summary \
Python project
Node.js project
General (safe default)
pygount --format=summary /path/to/repo 2>/dev/null | grep -E "^\s+\w" | sort -t$'\t' -k2 -rn
pygount --format=json \
python3 -c "
import json