User Stories

Analyzes a codebase and breaks down a goal into implementable user stories with clear acceptance criteria. Use when planning a new feature, estimating work, or creating a development roadmap. Explores the code before asking anything; when the goal is ambiguous, asks at most 5 blocking multiple-choice questions with a recommended answer, and records assumptions and open questions in the plan. Outputs execution-ready stories (schema v2: type, status, a verify check per criterion, dependencies with reasons, interfaces, files to reuse, file conflicts for parallel work) to .context/[goal-slug]-plan

9 stars 2 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add felipereisdev/user-stories-skill --skill user-stories

Manual install

git clone --depth 1 https://github.com/felipereisdev/user-stories-skill.git /tmp/user-stories-skill
mkdir -p ~/.claude/skills
cp -r /tmp/user-stories-skill/. ~/.claude/skills/user-stories

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# User Stories - Codebase Analysis & Story Breakdown

Analyze a codebase and break down a goal into small, atomic, implementable user stories. **Do NOT implement anything — only analyze and plan.** The plan file in `.context/` (written first as a `.draft.md` and then renamed) is the only file you write — never create, edit or delete any other file.

## Input

If `$ARGUMENTS` is empty (no goal), do not explore the code and do not write any file. End your response with only this: "What goal would you like to break down into user stories? You can optionally add `--format=gherkin` for BDD-style output." followed by the line "_Calling agent: show this question to the user. When the user replies, run this skill again with their goal as the argument. Do not write the plan yourself._"

Otherwise, extract the goal, the optional format flag (`--format=json` default, or `--format=gherkin`) and the optional `--answers="..."`, which carries the user's answers to the clarifying questions of an earlier run (see [Clarification Protocol](#clarification-protocol)). If the format is invalid: "Invalid format. Use `--format=json` (default) or `--format=gherkin` for BDD-style output." The filename comes from the goal only, never from the flags.

## Workflow

Read the full skill on GitHub

Details

Skill name: user-stories
Repository: felipereisdev/user-stories-skill
License: MIT
Repo updated: 26 October 2026

FAQ

What does the User Stories skill do?

How do I install the User Stories skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add felipereisdev/user-stories-skill --skill user-stories. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is User Stories popular?

It lives in felipereisdev/user-stories-skill, which has 9 GitHub stars and 2 forks.

Related skills

Cl1 Base

SeanCole02/cl1-base

Build or adapt baseline CL1 human-neuron models, stimulation loops, and evaluation workflows. Use when Codex needs to design or modify CL1 training code, UDP stimulation and spike protocols, safe stimulation ranges, Same Frame Encoding (SFE), ablations, feedback-channel logic, or hardware-aware data and training loops for CL1 systems.

Software Development

Perf Hints

omarkilani/perf-hints

Improve C++ (C++11+) performance using Abseil “Performance Hints” (Jeff Dean & Sanjay Ghemawat): estimation + profiling, API/bulk design, algorithmic wins, cache-friendly memory layout, fewer allocations, fast paths, caching, and compiler-friendly hot loops. Use for performance code reviews, refactors, and profiling-driven optimizations. Keywords: performance, latency, throughput, cache, allocation, memory layout, InlinedVector, string_view, Span, flat_hash_map, pprof, perf.

Software Development

4d V21

Ganbin/4d-development-skill

Comprehensive 4D v21 development expert with embedded official documentation. Covers ORDA patterns, entity classes, data model classes, queries, classic methods, data types, error handling, forms, events, web server, and REST API. Use when working with 4D files (.4dm), 4D language questions, 4D project structure, entity classes, ORDA queries, database operations, form development, web server configuration, REST API usage, or any 4D-specific syntax issue. Includes full official 4D v21 documentation for on-demand retrieval. Triggers on: .4dm files, 4D code, ORDA, entity selection, dataclass, 4D

Software Development

Cc Claude Codex

leyuan0602-glitch/cc-claude-codex

Development skill where Claude Code acts as supervisor and Codex acts as executor. Auto-trigger for implementation, debugging, refactoring, testing, and other dev tasks.

Software Development

Data Oriented Design

Data-Oriented-Design-for-Games/data-oriented-design

Language-agnostic architecture guide for building games and performance-sensitive apps with Data-Oriented Design (DOD) — adapted from *High Performance Unity Game Development (Using data-oriented design)* by Nitzan Wilnai, generalized to any language and with a first-class HTML5/JavaScript/Canvas track. Use this skill whenever building or reviewing a game (or real-time/simulation code) in DOD style outside Unity — especially HTML/JS/Canvas, but also C, C++, Rust, Go, Zig, or plain C#. Trigger when the user asks to: scaffold a game or feature in DOD style, generate DOD-compliant code, review co

Software Development

Bilibili Digest

lll888666/bilibili-digest

解析 B 站视频并生成干货报告：提取字幕或本地 faster-whisper 转录、抓取高赞评论、总结要点、提取资源链接、输出 Mermaid 思维导图。零第三方 API Key。当用户提供 bilibili.com 链接、BV 号，或说「总结这个 B 站视频」「B 站干货」「视频逐字稿」「消化 B 站视频」时必须使用本 skill。

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.