Installation

Choose the installation method that best fits your workflow.

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/

Option 2: Claude Code Plugin

If you use Claude Code, install via its built-in plugin system:

# Add the marketplace
/plugin marketplace add specstoryai/agent-skills

# Install all SpecStory skills
/plugin install specstory-skills

Option 3: Clone and Copy

Clone the entire repo and copy the skills folder:

git clone https://github.com/specstoryai/agent-skills.git
cp -r agent-skills/skills/* .claude/skills/

Option 4: Git Submodule

Add as a submodule for easy updates:

git submodule add https://github.com/specstoryai/agent-skills.git .claude/agent-skills

Then reference skills from .claude/agent-skills/skills/.

Option 5: Fork and Customize

1. Fork the agent-skills repository
2. Customize skills for your specific needs
3. Clone your fork into your projects

This is ideal if you want to:

• Modify existing skills
• Add private skills not suitable for public sharing
• Maintain a consistent set of skills across your organization

Verifying Installation

After installation, verify skills are available by asking your AI assistant:

"What SpecStory skills do I have installed?"

Or check the skills directory directly:

ls .claude/skills/
# or
ls .agents/skills/

Next Steps

• See Available Skills for the full list
• Contribute your own skills