gsd-stats — Claude Code skill for project stats
The gsd-stats Claude Code skill reports project progress and metrics. Ask it to summarize phases, plans, requirements, Git history, or the project timeline.
MIT 574 installs ★ 11,761 updated 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-stats -a claude-codeWhat gsd-stats does
The skill gathers project figures across phase progress, plan execution, completed requirements, Git history, and the project timeline. It brings work status and timing into one report.
It follows the instructions in ~/.claude/gsd-core/workflows/stats.md and uses Read, Bash, and Grep. Git metrics come from repository history.
What it helps with
- summarize progress across project phases
- measure plan execution
- check requirement completion
- inspect Git history metrics
- assemble a project timeline
Example prompts for the agent
- Show project stats for phases and plans.
- Summarize completed requirements and Git history.
- Build a timeline for the project.
How to install gsd-stats
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-stats -a claude-code2Manually: put the files in place
~/.claude/skills/gsd-stats/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gsd-stats/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-stats -a codex2Manually: put the files in place
.agents/skills/gsd-stats/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-stats -a cursor2Manually: put the files in place
.cursor/skills/gsd-stats/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-stats2Manually: put the files in place
.github/skills/gsd-stats/SKILL.md1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-stats -a gemini-cli2Platform CLI
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-statsManually: put the files in place
.devin/skills/gsd-stats/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-stats -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gsd-stats
How do I install gsd-stats in Claude Code?
Run npx skills add open-gsd/gsd-core --skill gsd-stats -a claude-code. The skill file is at ~/.claude/skills/gsd-stats/SKILL.md.
What does gsd-stats do?
It reports phase progress, plan execution, requirement completion, Git history metrics, and the project timeline.
Which metrics does gsd-stats show?
It covers phase and plan progress, completed requirements, Git history statistics, and project timing.
Source text
SKILL.md · MIT
--- name: gsd-stats description: "Display project statistics — phases, plans, requirements, git metrics, and timeline" allowed-tools: - Read - Bash - Grep --- <objective> Display comprehensive project statistics including phase progress, plan execution metrics, requirements completion, git history stats, and project timeline. </objective> <execution_context> @~/.claude/gsd-core/workflows/stats.md </execution_context> <process> Execute end-to-end. </process>
© open-gsd · MIT · open-gsd/gsd-core