# user-story

> Claude/Codex skill by [@deanpeters](https://omgskills.com/library/deanpeters/index.md) · 7.5k stars · Updated 2026-10-16

Create user stories with Mike Cohn format and Gherkin acceptance criteria. Use when turning user needs into development-ready work with clear outcomes and testable conditions.

Tags: ai-agents, ai-product-management, claude-skills, pm-frameworks, product-management

## Install

```sh
git clone https://github.com/deanpeters/Product-Manager-Skills /tmp/Product-Manager-Skills && ln -s /tmp/Product-Manager-Skills/skills/user-story ~/.claude/skills/user-story
```

## From README

Purpose Create clear, concise user stories that combine Mike Cohn's user story format with Gherkin-style acceptance criteria. Use this to translate user needs into actionable development work that focuses on outcomes, ensures shared understanding between product and engineering, and provides testable success criteria. This is not a feature spec—it's a conversation starter that captures who benefits, what they're trying to do, why it matters, and how you'll know it works. Input Works best with: The feature or user need the story captures. Also useful: The user role, the outcome they want, and edge cases the acceptance criteria must cover. Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended ARGUMENTS: line — counts as answers already given. Use it and skip whatever it covers; don't re-ask. Arriving empty-handed? That works too.

## Links

- HTML page: https://omgskills.com/skills/deanpeters/product-manager-skills/user-story/
- GitHub: https://github.com/deanpeters/Product-Manager-Skills
- Author: [@deanpeters](https://omgskills.com/library/deanpeters/index.md)

## More from this repo

- [acquisition-channel-advisor](https://omgskills.com/skills/deanpeters/product-manager-skills/acquisition-channel-advisor/index.md) — Evaluate acquisition channels using unit economics, customer quality, and scalability.
   - [@deanpeters](https://omgskills.com/library/deanpeters/index.md) · 7.5k stars
- [ai-shaped-readiness-advisor](https://omgskills.com/skills/deanpeters/product-manager-skills/ai-shaped-readiness-advisor/index.md) — Assess whether your product work is AI-first or AI-shaped.
   - [@deanpeters](https://omgskills.com/library/deanpeters/index.md) · 7.5k stars
- [altitude-horizon-framework](https://omgskills.com/skills/deanpeters/product-manager-skills/altitude-horizon-framework/index.md) — Understand the PM-to-Director transition through altitude and horizon thinking.
   - [@deanpeters](https://omgskills.com/library/deanpeters/index.md) · 7.5k stars