SKILL.md 1.6 KB
name: code-stats
description: Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs). Get quick project overview without manual counting. Triggers on: how big is codebase, count lines of code, what languages, show semantic diff, compare files, code statistics.
Code Statistics
Purpose
Quickly analyze codebase size, composition, and changes with token-efficient output.
Tools
| Tool | Command | Use For |
|---|---|---|
| tokei | tokei |
Line counts by language |
| difft | difft file1 file2 |
Semantic AST-aware diffs |
Usage Examples
Code Statistics with tokei
# Count all code in current directory
tokei
# Count specific directory
tokei src/
# Count specific languages
tokei --type=Python,JavaScript
# Compact output
tokei --compact
# Sort by lines of code
tokei --sort=code
# Exclude directories
tokei --exclude=node_modules --exclude=vendor
Semantic Diffs with difft
# Compare two files
difft old.py new.py
# Use as git difftool
git difftool --tool=difftastic HEAD~1
# Compare directories
difft dir1/ dir2/
# Inline display mode
difft --display=inline old.js new.js
Output Interpretation
tokei output
- Lines: Total lines including blanks
- Code: Actual code lines
- Comments: Comment lines
- Blanks: Empty lines
difft output
- Shows structural changes, not line-by-line
- Highlights moved code blocks
- Ignores whitespace-only changes
When to Use
- Getting quick codebase overview
- Comparing code changes semantically
- Understanding project composition
- Reviewing refactoring impact
- Estimating project size