Agent Skills
SpecStory's official collection of agent skills. Summarize, organize and create with `.specstory/history`
Install: npx skills add specstoryai/agent-skills
Works with Claude Code · 35 GitHub stars
Install
npx skills add specstoryai/agent-skillsInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Agent Skills for SpecStory
A collection of AI agent skills for working with SpecStory session histories. Built for developers who want Claude Code (or similar AI coding assistants) to help analyze, organize, and extract insights from their AI-assisted coding sessions.
Contributions welcome! Found a way to improve a skill or have a new one to add? Open a PR.
What are Skills?
Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, Claude Code (or agents like Codex, Cursor, Gemini, Copilot) can recognize relevant tasks and apply the right frameworks and analysis patterns.
Prerequisites
These skills work with your local .specstory/history directory (or cloud.specstory.com APIs), which is created by SpecStory when capturing AI coding sessions.
Install SpecStory for your tool:
| Tool | Installation |
|---|---|
| Cursor / VS Code | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) |
| Claude Code / CLI agents | brew tap specstoryai/tap && brew install specstory |
Once installed, your AI conversations are automatically saved to .specstory/history/ in each project.
Note for contributors: Don't run
npx skills addfrom within this repo - it will install skills into the repo directory. The.gitignoreexcludes these directories, but install skills in your actual projects instead.
Available Skills
| Skill | Description |
|---|---|
| specstory-guard | Install a pre-commit hook that scans .specstory/history for secrets before commits. Run when user says "set up secret... |
| specstory-link-trail | Track all URLs fetched during SpecStory AI coding sessions. Run when user says "show my link trail", "what URLs did I... |
| specstory-organize | Organize SpecStory AI coding sessions in .specstory/history into year/month folders. Run when user says "organize my... |
| specstory-project-stats | Fetch project statistics from SpecStory Cloud. Run when user says "get project stats", "show SpecStory stats", "project... |
| specstory-session-summary | Summarize recent SpecStory AI coding sessions in standup format. Use when the user wants to review sessions from... |
| specstory-yak | Analyze your SpecStory AI coding sessions in .specstory/history for yak shaving - when your initial goal got derailed... |
Installation
Option 1: Skills CLI (Recommended)
Use npx skills 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.). The CLI auto-detects which agents you have installed.
Option 2: Clone and Copy
Clone the entire repo and copy the skills folder:
Similar plugs
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…
Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.
Production-grade engineering skills for AI coding agents.
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…