Specstory Yak
Ever started to fix a button and ended up rewriting your entire CI/CD pipeline? This analyzer digs through your SpecStory session history and scores each one from 0 to 100 based on how far you drifted from your original goal. It tracks domain shifts, tool escalation patterns, and goal completion to identify your worst yak shaving offenders. The output is genuinely useful: it'll tell you that your UI tasks average a 58/100 yak shave score while your code reviews stay focused at 12/100, or that your 11pm sessions are where things go off the rails. Run it with "/specstory-yak last 30 days" and get a personalized roast of your most epic scope creep moments.
- skills.sh installs
- 253
- GitHub stars
- 35
- last updated
- Aug 21, 2026
Install
$ npx -y skills add specstoryai/agent-skills --skill specstory-yak --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
- Parses specstory history files from a date range (or all recent sessions)
- Extracts the initial user intent from the first message
- Tracks domain shifts: file references, tool call patterns, goal changes
- Scores each session from 0 (laser focused) to 100 (maximum yak shave)
- 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
Slash Command
When invoked via /specstory-yak, interpret the user's natural language:
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/specstoryai/agent-skills
- Category
- AI & Agent Building
- First seen
- Jun 3, 2026
More from specstoryai/agent-skills
All 6Recommended
More AI & Agent Building
accessibilitytech-leads-club/agent-skillsAudit and improve web accessibility following WCAG 2.1 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader su253skills.sh installs
godot-ability-systemthedivergentai/gd-agentic-skillsExpert patterns for RPG/action ability systems including cooldown strategies, combo systems, ability chaining, skill trees with prerequisites, upgrade paths, an253skills.sh installsgodot-performance-optimizationthedivergentai/gd-agentic-skillsExpert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, an253skills.sh installsexcalidraw-studiotech-leads-club/agent-skillsGenerate Excalidraw diagrams from natural language descriptions. Outputs .excalidraw JSON files openable in Excalidraw. Use when asked to "create a diagram", "m251skills.sh installsgodot-ui-rich-textthedivergentai/gd-agentic-skillsExpert blueprint for RichTextLabel with BBCode formatting (bold, italic, colors, images, clickable links) and custom effects. Covers meta tags, RichTextEffect s251skills.sh installs
magento-php-specialistmaxnorm/magento2-agent-skillsAdvanced PHP development for Magento 2 following PSR-12 and Magento coding standards. Use when writing PHP code, implementing business logic, or ensuring code q249skills.sh installs