Specstory Project Stats

Quick way to pull analytics from SpecStory Cloud about your project's AI coding sessions. It figures out your project ID from git remotes or local config, hits their API, and shows you contributor counts, session activity over different time windows, and weekly averages. The output formatting is thoughtful, dates are humanized, and it handles the common 404 case when you haven't synced yet. Useful if you're tracking how much your team is leaning on AI assistance or just curious about usage patterns. No auth required for basic stats, which is nice for quick checks.

skills.sh installs: 238
GitHub stars: 35
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add specstoryai/agent-skills --skill specstory-project-stats --agent claude-code

Installs into .claude/skills of the current project.

Files

SpecStory Project Stats

Fetches project statistics from SpecStory's cloud platform, showing contributor counts, session activity, and other project metrics.

How It Works

Identifies the project via .specstory/.project.json, git remote, or folder name
Calls the SpecStory Cloud API
Returns project statistics in JSON format
Presents the data in a readable summary

Prerequisites

Project must be synced to SpecStory Cloud
Node.js must be available to run the script

Usage

Slash Command

User says	Action
`/specstory-project-stats`	Fetch stats for current project
`/specstory-project-stats`	Same as above (no arguments needed)

Direct Script Usage

# Fetch stats for current project
node skills/specstory-project-stats/scripts/get-stats.js

# With custom API endpoint (for development)
SPECSTORY_API_URL=http://localhost:5173 node skills/specstory-project-stats/scripts/get-stats.js