project-stats

Project Stats Report

Generate a comprehensive, comparable project statistics report. Works on any git project.

How It Works

1. Run the bundled collection script to gather raw data
2. Save the JSON report to .claude/reports/
3. Find the most recent previous report (if any)
4. Compare and present a formatted markdown report with trend indicators

Step 1: Collect Statistics

Run the bundled collection script from the project root:

bash <skill-path>/scripts/collect-stats.sh

Capture the JSON output. The script auto-detects:

• Languages: TypeScript, JavaScript, Python, Go, Rust, PHP, Java, Swift, Kotlin, CSS
• Monorepo: Turborepo, Lerna, Nx, pnpm workspaces
• Frameworks: Next.js, Vite, Nuxt, Angular, SvelteKit, Astro, Expo, FastAPI, Django, Rails
• Tests: .spec.*, .test.*, test_*.py, E2E files
• Git: commits, contributors, branches, tags, velocity, conventional commit types, AI collab ratio
• Dependencies: npm, pip, go modules
• Quality: TODOs, FIXMEs
• i18n: keys, locales

Step 2: Save the Report

Save the JSON output to .claude/reports/project-stats-YYYY-MM-DD.json in the project root. Create the directory if it doesn't exist.

If a report for today already exists, overwrite it (same-day re-runs update rather than duplicate).

Step 3: Find Previous Report

Look in .claude/reports/ for the most recent project-stats-*.json file that is NOT today's report. Read it for comparison.

If the project has a custom metrics script (like pnpm dev:metrics --save or similar), also check those output directories for additional historical data.

Step 4: Format the Report

Present the report in this structure. The comparison column only appears when a previous report exists.

Report Template

# 📊 Project Statistics Report

**Project:** {name}
**Date:** {date}
**Previous report:** {previous_date or "First report"}

---

## Overview

| Metric | Current | Previous | Delta |
|--------|---------|----------|-------|
| Source files | X | Y | ↑ +Z (+N%) |
| Lines of code | X | Y | ↓ -Z (-N%) |
| Test files | X | Y | → 0 |
| Git commits (total) | X | Y | ↑ +Z |
| Contributors | X | | |

## Language Breakdown

| Language | Files | LOC | % of Total |
|----------|-------|-----|------------|
| TypeScript | X | Y | Z% |
| ... | | | |

## Git Activity

| Metric | Value |
|--------|-------|
| Commits today | X |
| Commits this week | X |
| Commits this month | X |
| Branches | X |
| Tags | X |
| Dirty files | X |
| Unpushed commits | X |

### Commit Types (Last 30 days)

| Type | Count | Bar |
|------|-------|-----|
| feat | X | ████████ |
| fix | X | ██████ |
| ... | | |

### AI Collaboration

| Metric | Value |
|--------|-------|
| AI-assisted commits (30d) | X |
| AI collab ratio | X% |

## Weekly Velocity

| Metric | Current | Previous | Delta |
|--------|---------|----------|-------|
| Lines added | X | Y | |
| Lines removed | X | Y | |
| Net lines | X | Y | |

## Testing

| Metric | Current | Previous | Delta |
|--------|---------|----------|-------|
| Unit test files | X | Y | |
| E2E test files | X | Y | |
| Total test files | X | Y | |

## Dependencies

| Source | Production | Dev |
|--------|-----------|-----|
| npm | X | Y |
| Python | X | |
| Go | X | |

## Infrastructure

| Property | Value |
|----------|-------|
| Monorepo | Yes/No |
| Tool | Turborepo / Lerna / etc |
| Workspaces | X |
| Frameworks | Next.js, FastAPI, etc |
| Dockerfiles | X |
| Docker Compose | Yes/No |

## Code Quality

| Metric | Current | Previous | Delta |
|--------|---------|----------|-------|
| TODOs | X | Y | |
| FIXMEs/HACKs | X | Y | |

## i18n (if applicable)

| Metric | Value |
|--------|-------|
| Translation keys | X |
| Locales | pt-BR, en-US, ... |