a-organvm/specstory-project-stats
distributions/codex/skills/specstory-project-stats/SKILL.md
Fetch project statistics from SpecStory Cloud. Run when user says "get project stats", "show SpecStory stats", "project statistics", "how many sessions", or "SpecStory metrics".
$ install --global
skillsauthnpx skillsauth add a-organvm/a-i--skills specstory-project-statsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 6:15 AM15.2s6 files scanned
SKILL.md
- name:
- specstory-project-stats
- description:
- Fetch project statistics from SpecStory Cloud. Run when user says "get project stats", "show SpecStory stats", "project statistics", "how many sessions", or "SpecStory metrics".
- license:
- Apache-2.0
- author:
- SpecStory, Inc.
- version:
- 1.0.0
- allowed-tools:
- Bash(node *)
- governance_phases:
- [frame]
- organ_affinity:
- [organ-iv]
- triggers:
- [command:project-stats, user-asks-about-specstory-stats]
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
Output
The script outputs JSON with project statistics:
{
"project_id": "specstoryai/agent-skills",
"sessions": {
"total": 156,
"last_30_days": 47,
"last_7_days": 12
},
"contributors": {
"total": 5,
"active_last_30_days": 3
},
"activity": {
"first_session": "2025-10-15",
"last_session": "2026-01-28",
"avg_sessions_per_week": 8.2
}
}
Project ID Resolution
The script determines project ID in this order:
.specstory/.project.json- Usesgit_idorworkspace_idfield- Git remote - Extracts repo name from
originremote URL - Folder name - Falls back to current directory name
Error Handling
| Error | Meaning | Action | |-------|---------|--------| | 404 | Project not found | Project needs to sync to SpecStory Cloud first | | 401 | Unauthorized | API endpoint may require authentication | | Network error | Can't reach API | Check internet connection |
Present Results to User
After fetching stats, present them in a friendly format:
Example Response (success)
Here are the stats for **specstoryai/agent-skills**:
**Sessions**
- Total: 156 sessions captured
- Last 30 days: 47 sessions
- Last 7 days: 12 sessions
**Contributors**
- Total: 5 contributors
- Active recently: 3
**Activity**
- First session: October 15, 2025
- Most recent: January 28, 2026
- Average: ~8 sessions per week
Your project has been actively using AI-assisted coding!
Example Response (404 error)
This project doesn't exist on SpecStory Cloud yet.
To get started:
1. Make sure you have SpecStory installed
2. Run `specstory sync` to push your local sessions to the cloud
3. Try this command again
Need help? Check the docs at https://docs.specstory.com
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| SPECSTORY_API_URL | https://cloud.specstory.com | API endpoint |
Notes
- Statistics are fetched from SpecStory Cloud, not local history
- Project must have synced sessions to show meaningful stats
- The API is public and doesn't require authentication for basic stats
Related Skills
a-organvm/docx
development
VerifiedTrustedCommunity
Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks
12SKILL.mdUpdated Jul 20, 2026
a-organvm/workspace-autopsy-governance
development
VerifiedTrustedCommunity
Conducts a full automated autopsy of the current workspace directory to map files, identifies structural issues, proposes a restructuring plan (the signal), and establishes unified governance using templates. Use this skill when a user asks to map, restructure, reorganize, or apply new governance to an existing messy repository.
12SKILL.mdUpdated Jul 20, 2026
a-organvm/workshop-presentation-design
testing
VerifiedTrustedCommunity
Design engaging workshops, conference talks, and educational presentations. Covers learning objectives, activity design, slide craft, and facilitation techniques. Triggers on workshop design, presentation prep, talk structure, or training session requests.
12SKILL.mdUpdated Jul 20, 2026
a-organvm/webhook-integration-patterns
development
VerifiedTrustedCommunity
Designs reliable webhook systems with proper delivery guarantees, retry logic, signature verification, and idempotent processing for event-driven integrations.
12SKILL.mdUpdated Jul 20, 2026