Analyzes AI coding history to detect and score sessions that drifted into unproductive rabbit holes.
The SpecStory Yak Shave Analyzer helps developers maintain focus by reviewing .specstory/history files to identify instances of 'yak shaving'—where a simple initial goal spirals into unrelated complex tasks. By calculating a specialized score based on domain shifts, tool call patterns, and goal completion, the skill provides objective feedback on session efficiency. It is an essential tool for developers looking to audit their AI-assisted workflows, identify distraction patterns, and ensure they remain laser-focused on their primary objectives.
Key Features
01Calculates a 0-100 Yak Shave Score based on domain shifts and tool cascades
02Automated parsing of .specstory history files across custom date ranges
032 GitHub stars
04Generates personalized, witty LLM summaries with actionable productivity advice
05Exports reports in multiple formats including Markdown and JSON
06Identifies specific patterns like peak distraction hours and high-risk task types
Use Cases
01Exporting session data to track long-term improvement in AI-assisted coding focus
02Conducting weekly productivity audits to see where development time was lost to scope creep
03Identifying which technical domains (like UI or DevOps) trigger the most rabbit holes
