Skip to content

SpecStory project stats#1

Merged
bago2k4 merged 7 commits into
mainfrom
skill/project-stats
Jan 28, 2026
Merged

SpecStory project stats#1
bago2k4 merged 7 commits into
mainfrom
skill/project-stats

Conversation

@bago2k4

@bago2k4 bago2k4 commented Jan 28, 2026

Copy link
Copy Markdown
Contributor

Given a project id (from .project.json or calculated on the fly), ask the server for the stats of the given project.

The server, once this PR is merged, will return a bunch of statistics of the project, included how many users have participated, how many different agents and clients have been used, how many sessions and exchanges etc.

Example output:

bago@Mac-mini:~/code/getspecstory [node v22.1.0]¥[npm 10.8.2]∆[ruby-3.3.0]
git:(copilot-ide*) ⚡︎claude
                                                                                                                           
 ▐▛███▜▌   Claude Code v2.1.22                                                                                             
▝▜█████▛▘  Sonnet 4.5 · API Usage Billing                                                                                  
  ▘▘ ▝▝    ~/code/getspecstory                                                                                             
                                                                                                                           
❯ /specstory-project-stats                                                                                                     
                                                                                                                           
⏺ I'll fetch the open source statistics for this project from SpecStory's cloud platform.                                  
                                                                                                                           
⏺ Bash(node /Users/bago/.claude/skills/specstory-project-stats/get-stats.js)                                                   
  ⎿  Loading .zprofile                                                                                                     
     Project ID: 362c-c03a-02ec-4952                                                                                       
     Fetching stats from: http://localhost:5173/api/v1/projects/362c-c03a-02ec-4952/stats                                  
     … +45 lines (ctrl+o to expand)                                                                                        
                                                                                                                           
⏺ SpecStory OSS Statistics for getspecstory                                                                                
                                                                                                                           
  Project ID: 362c-c03a-02ec-4952                                                                                          
                                                                                                                           
  Activity Overview                                                                                                        
                                                                                                                           
  - Total Sessions: 18                                                                                                     
  - Total Exchanges: 48                                                                                                    
  - Average Exchanges per Session: 2.67                                                                                    
  - Unique Users: 1                                                                                                        
                                                                                                                           
  Time Range                                                                                                               
                                                                                                                           
  - First Activity: January 22, 2026                                                                                       
  - Last Activity: January 28, 2026                                                                                        
                                                                                                                           
  Agents Used                                                                                                              
                                                                                                                           
  1. Cursor IDE - 12 sessions (67%)                                                                                        
  2. Claude Code - 5 sessions (28%)                                                                                        
  3. VS Code Copilot IDE - 1 session (5%)                                                                                  
                                                                                                                           
  Client Information                                                                                                       
                                                                                                                           
  - specstory-cli (dev) - 18 sessions                                                                                      
                                                                                                                           
  Data Volume                                                                                                              
                                                                                                                           
  - Total Markdown Size: 2.03 MB                                                                                           
  - Total Raw Data Size: 16.97 MB                                                                                          
  - Average Session Size: 113 KB                                                                                           
                                                                                                                           
  The statistics show active development across multiple IDE integrations, with Cursor IDE being the most frequently used  
  agent in this project.                            

@bago2k4 bago2k4 requested a review from Copilot January 28, 2026 16:46
@bago2k4 bago2k4 self-assigned this Jan 28, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a new skill for fetching project statistics from SpecStory's cloud platform. The skill calculates a project ID using a deterministic algorithm (from .project.json, Git repository name, or folder name) and queries the SpecStory API for project statistics.

Changes:

  • Added a Node.js script that calculates project IDs and fetches statistics from the SpecStory API
  • Created skill documentation (SKILL.md) with usage instructions and error handling guidance
  • Added comprehensive README with details on project ID calculation, API endpoints, and usage examples

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
skills/specstory-project-stats/scripts/get-stats.js Implements the core logic for project ID calculation and API communication
skills/specstory-project-stats/SKILL.md Defines the Claude Code skill interface and invocation instructions
skills/specstory-project-stats/README.md Provides user-facing documentation with examples and configuration details

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/specstory-project-stats/scripts/get-stats.js
Comment thread skills/specstory-project-stats/SKILL.md
Comment thread skills/specstory-project-stats/README.md
@bago2k4 bago2k4 merged commit 052c6ba into main Jan 28, 2026
2 checks passed
@bago2k4 bago2k4 deleted the skill/project-stats branch January 28, 2026 18:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants