specstory-yak

Analyze SpecStory session history to score yak shaving and goal derailment.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/zapabob/Skills --skill specstory-yak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specstory-yak
Source: https://github.com/zapabob/Skills/tree/main/registry/skills/specstory-yak/variants/cursor
Command: npx skills add https://github.com/zapabob/Skills --skill specstory-yak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you understand how often and why your AI coding sessions get sidetracked from the original goal, providing insights into "yak shaving" behavior.

Core Features & Use Cases

  • Yak Shave Scoring: Assigns a score (0-100) to each session based on goal drift, domain shifts, and session length.
  • Pattern Identification: Highlights common triggers for distraction, like specific task types or times of day.
  • Use Case: After a complex coding session, use this Skill to see if you stayed on track or ended up deep in unrelated tasks, helping you improve focus for future work.

Quick Start

Run the specstory yak analyzer for the last 7 days to see your yak shave score.

Frequently Asked Questions about specstory-yak

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect yak shaving and goal derailment in AI coding sessions?

Detect goal derailment by parsing AI coding session history to track domain shifts and quantify deviations from initial intent. This analysis scores your sessions to highlight exactly how and when your focus drifted from the original task.

What is a yak shave score for coding sessions?

A yak shave score is a 0-100 metric assigned to AI coding sessions based on goal drift, domain shifts, and session length. It quantifies how severely your workflow derailed from its original objective.

Does SpecStory session analysis require specific files or environments?

SpecStory session analysis requires access to .specstory/history files and a Python execution environment. You need these specific local history files available to parse and evaluate your past coding sessions.

How do I identify common triggers for distractions in my AI coding history?

Identify distraction triggers by analyzing session history to highlight common patterns like specific task types or times of day. This pattern identification pinpoints exactly what causes your coding focus to shift away.

Can I analyze SpecStory history files for the last 7 days of coding?

You can analyze SpecStory history files over a 7-day period to calculate your yak shave score. This quick start check helps you review recent sessions and see if you stayed on track or ended up in unrelated tasks.