gsd-stats

name: gsd-stats description: "Display project statistics — phases, plans, requirements, git metrics, and timeline" allowed-tools:

• Read
• Bash

<required_reading> Read the skill content below before starting. </required_reading>

STATS=$(node "$GSD_TOOLS" stats json)
if [[ "$STATS" == @file:* ]]; then STATS=$(cat "${STATS#@file:}"); fi

Extract fields from JSON: milestone_version, milestone_name, phases, phases_completed, phases_total, total_plans, total_summaries, percent, plan_percent, requirements_total, requirements_complete, git_commits, git_first_commit_date, last_activity. </step>

# 📊 Project Statistics — {milestone_version} {milestone_name}

## Progress
[████████░░] X/Y phases (Z%)

## Plans
X/Y plans complete (Z%)

## Phases
| Phase | Name | Plans | Completed | Status |
|-------|------|-------|-----------|--------|
| ...   | ...  | ...   | ...       | ...    |

## Requirements
✅ X/Y requirements complete

## Git
- **Commits:** N
- **Started:** YYYY-MM-DD
- **Last activity:** YYYY-MM-DD

## Timeline
- **Project age:** N days

If no .planning/ directory exists, inform the user to run /gsd-new-project first. </step>

<success_criteria>

• Statistics gathered from project state
• Results formatted clearly
• Displayed to user </success_criteria>