User Stories Skill — Development skill for Claude Code

User Stories Skill 🎯

[](https://github.com/felipereisdev/user-stories-skill) [](https://opensource.org/licenses/MIT) [](https://agentskills.io) [](https://claude.ai) [](https://opencode.ai)

An Agent Skill that analyzes codebases and breaks down goals into implementable user stories with clear acceptance criteria.

**Compatible with any LLM that supports the [Agent Skills Standard](https://agentskills.io)** - Claude Code, OpenCode, Cursor, and any other AI coding assistant that implements the skills protocol.

🌟 Features

• Automatic Codebase Analysis - Understands your project architecture and patterns
• Atomic User Stories - Breaks goals into 2-4 hour implementable chunks
• Dependency Ordering - Stories ordered so earlier ones enable later ones
• Clear Acceptance Criteria - Every story has verifiable completion criteria
• Dynamic File Naming - Generates descriptive filenames based on your goal
• Multiple Output Formats - Choose between JSON (default) or Gherkin (BDD)
• Plan Mode Compatible - Works safely without making code changes
• Universal Compatibility - Works with any LLM supporting Agent Skills

📦 Installation

Option 1: Direct Clone (Universal)

Works with any AI assistant:

git clone https://github.com/felipereisdev/user-stories-skill.git

Then configure your AI assistant to load skills from the cloned directory.

Option 2: Claude Code

# Clone into your global skills
mkdir -p ~/.claude/skills
ln -s "$(pwd)/user-stories" ~/.claude/skills/user-stories

Option 3: OpenCode/Codex

# Clone into