Analyzes codebase size and semantic differences quickly via command-line tools.

Install

mkdir -p .claude/skills/code-stats && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19381" && unzip -o skill.zip -d .claude/skills/code-stats && rm skill.zip

Installs to .claude/skills/code-stats

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

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.
271 charsno explicit “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • Calculate total lines of code by language using tokei
  • Generate compact codebase statistics sorted by code volume
  • Perform semantic diffs between files using difft
  • Integrate semantic diffing into git workflows
  • Filter line counts by specific programming languages
  • Exclude specific directories from codebase analysis

How it works

The skill executes tokei to perform rapid line counts and difft to generate AST-aware semantic diffs. It uses Bash commands to interface with these tools for project analysis.

Inputs & outputs

You give it
File paths or directory paths
You get back
Formatted line count tables or semantic diff output

When to use code-stats

  • Count total lines of code by language
  • View semantic changes between file versions
  • Generate a project size overview

About this skill

Code Statistics

Quickly analyze codebase size, composition, and changes.

tokei - Line Counts

# Count all code
tokei

# Compact output sorted by code
tokei --compact --sort code

# Specific languages
tokei --type=TypeScript,JavaScript

# Exclude directories
tokei --exclude node_modules --exclude dist

# JSON output for scripting
tokei --output json | jq '.Total.code'

Sample Output

===============================================================================
 Language            Files        Lines         Code     Comments       Blanks
===============================================================================
 TypeScript             45        12847         9823         1456         1568
 JavaScript             12         2341         1876          234          231
-------------------------------------------------------------------------------
 Total                  57        15188        11699         1690         1799
===============================================================================

difft - Semantic Diffs

# Compare files
difft old.ts new.ts

# Inline mode
difft --display=inline old.ts new.ts

# With git
GIT_EXTERNAL_DIFF=difft git diff
GIT_EXTERNAL_DIFF=difft git show HEAD~1

Why Semantic?

Traditional diffdifft
Line-by-lineAST-aware
Shows moved as delete+addRecognizes moves
Whitespace sensitiveIgnores formatting

Quick Reference

TaskCommand
Count all codetokei
Compact outputtokei --compact
Sort by codetokei --sort code
TypeScript onlytokei -t TypeScript
JSON outputtokei --output json
Exclude dirtokei --exclude node_modules
Semantic diffdifft file1 file2
Git diffGIT_EXTERNAL_DIFF=difft git diff

When to Use

  • Getting quick codebase overview
  • Comparing code changes semantically
  • Understanding project composition
  • Reviewing refactoring impact
  • Tracking codebase growth

Additional Resources

For detailed patterns, load:

  • ./references/tokei-advanced.md - Filtering, output formats, CI integration
  • ./references/difft-advanced.md - Display modes, git integration, language support

Prerequisites

tokei CLI tooldifft CLI tool

How it compares

Unlike traditional line-by-line diff tools, this approach uses AST-aware logic to ignore formatting changes and recognize moved code blocks.

Compared to similar skills

code-stats side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
code-stats (this skill)03moReviewBeginner
tech-debt-tracker11moReviewIntermediate
quality-engineering-zephyr-coverage-analysis02moNo flagsIntermediate
quality04moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry