Specstory Yak Shave Analyzer

Analyzes your .specstory/history to detect when coding sessions drifted off track from their original goal. Produces a "yak shave score" for each session.

How It Works

1. Parses specstory history files from a date range (or all recent sessions)
2. Extracts the initial user intent from the first message
3. Tracks domain shifts: file references, tool call patterns, goal changes
4. Scores each session from 0 (laser focused) to 100 (maximum yak shave)
5. Summarizes your worst offenders and patterns

What Is Yak Shaving?

"I need to deploy my app, but first I need to fix CI, but first I need to update Node, but first I need to fix my shell config..."

Yak shaving is when you start with Goal A but end up deep in unrelated Task Z. This skill detects that pattern in your AI coding sessions.

Usage