SpecStory
Docs›Overview

Agent Skills

Overview

Extend your AI coding assistant with specialized skills for analyzing, organizing, and extracting insights from your SpecStory session histories.

Agent Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When installed, Claude Code (or agents like Codex, Cursor, Gemini, Copilot) can recognize relevant tasks and apply the right frameworks and analysis patterns.

Session Analysis

Analyze yak shaving, generate standup summaries, and track URLs fetched during sessions.

Organization & Maintenance

Keep your history organized by year/month and protect against accidental secret commits.

What are Skills?

Skills are structured markdown files that provide AI agents with:

  • Specialized knowledge for specific tasks
  • Workflow patterns for consistent execution
  • Analysis frameworks for extracting insights

When you install these skills, your AI assistant can recognize relevant tasks and automatically apply the appropriate skill.

Prerequisites

These skills work with your local .specstory/history directory, created by SpecStory when capturing AI coding sessions.

ToolInstallation
Cursor / VS CodeSearch "SpecStory" in Extensions (Cmd/Ctrl+Shift+X)
Claude Code / CLI agentsbrew tap specstoryai/tap && brew install specstory

Once installed, your AI conversations are automatically saved to .specstory/history/ in each project.

Quick Install

Use the Skills CLI to install skills directly:

# Install all skills
npx skills add specstoryai/agent-skills

# Install specific skills
npx skills add specstoryai/agent-skills --skill specstory-yak specstory-session-summary

# List available skills
npx skills add specstoryai/agent-skills --list

This installs skills to .agents/skills/ and symlinks them to each detected agent's directory (.claude/skills/, .cursor/skills/, .codex/skills/, etc.).

Tip

The CLI auto-detects which agents you have installed and sets up skills for all of them.

Usage

Once installed, just ask your AI assistant to help with SpecStory-related tasks:

"Analyze my yak shaving for the last 30 days"
→ Uses specstory-yak skill

"Summarize my coding sessions from this week"
→ Uses specstory-session-summary skill

"Organize my specstory history folder"
→ Uses specstory-organize skill

You can also invoke skills directly with slash commands:

/specstory-yak
/specstory-session-summary
/specstory-organize
/specstory-link-trail
/specstory-guard
/specstory-project-stats

Next Steps