Available Skills

All skills work with your local .specstory/history directory. Install them with:

npx skills add specstoryai/agent-skills

Session Analysis

Skills for extracting insights from your AI coding sessions.

specstory-yak

Detect rabbit holes and scope creep

Analyze your SpecStory AI coding sessions for yak shaving - when your initial goal got derailed into rabbit holes. Get a detailed report of how your session evolved and whether you stayed on track.

"Analyze my yak shaving for the last 30 days"
"Check for rabbit holes in my recent sessions"
"How distracted was I this week?"

View on GitHub

See the full skill definition and implementation details.

specstory-session-summary

Generate standup-ready summaries

Summarize recent SpecStory AI coding sessions in standup format. Perfect for quickly reviewing what you accomplished and preparing for team updates.

"Summarize my coding sessions from this week"
"What did I work on yesterday?"
"Give me a standup summary for the last 3 days"

View on GitHub

See the full skill definition and implementation details.

specstory-link-trail

Track all URLs fetched

Review SpecStory AI coding sessions and create a summary of all URLs that were fetched. Useful for auditing external resources accessed during development.

"What URLs did I visit in my last session?"
"Show me all links fetched this week"
"Create a link trail for my recent sessions"

View on GitHub

See the full skill definition and implementation details.

specstory-project-stats

Fetch project statistics

Fetch project statistics from SpecStory's cloud platform. Get insights about your project's AI-assisted development activity.

"Get project stats from SpecStory"
"Show my SpecStory project statistics"

View on GitHub

See the full skill definition and implementation details.

Organization & Maintenance

Skills for keeping your session history organized and secure.

specstory-organize

Organize into year/month folders

Organizes SpecStory AI coding sessions in the project's .specstory/history directory into year and month subfolders. Keeps your history clean and navigable.

"Organize my specstory history folder"
"Sort my session files by date"
"Clean up my .specstory directory"

View on GitHub

See the full skill definition and implementation details.

specstory-guard

Pre-commit hook for secrets

Install a pre-commit guardrail for SpecStory AI coding sessions that scans .specstory/history for potential secrets and sensitive data before committing.

"Set up secret scanning for my specstory files"
"Install the specstory guard hook"
"Protect my history from accidental secret commits"

Warning

This skill sets up a git pre-commit hook. Make sure you understand how it works before installing.

View on GitHub

See the full skill definition and implementation details.

Contributing

Have an idea for a new skill? Found a way to improve an existing one?

Contribute

Read the contribution guidelines and submit a PR.

The repository welcomes contributions for:

New analysis skills
Improved organization tools
Bug fixes and enhancements
Documentation improvements