How-to · Product Management · By Dean Peters (PM)

How to use User Story Writer in your AI agent

Install and use the User Story Writer skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill helps you write product user stories in a professional format that product managers use to communicate with engineering teams. You describe what a user wants to accomplish and why it matters, and the skill formats it properly with testable success criteria. Perfect for PMs, founders, and product leaders who need to translate customer needs into actionable work without writing code themselves.

Step 1 — Get the skill source URL

The User Story Writer skill lives at:

Open ↗

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story to my project.

Cursor

Install this agent skill: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story

Codex

Add this skill to .codex/skills/: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story

Gemini CLI

Add the skill at https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story

Windsurf

Add this skill: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/user-story

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • A PM or founder translating customer feedback into development work
  • Communicate a product requirement clearly to your engineering team
  • Prepping for sprint planning and need properly formatted backlog items
  • Ensure acceptance criteria are testable before development starts

What this skill does

  • Formats user needs using the industry-standard Mike Cohn template (As a/I want/So that)
  • Generates Gherkin-style acceptance criteria that define when the work is done
  • Ensures stories focus on user outcomes rather than just features or tasks
  • Provides quality checks to catch vague requirements before they reach the dev team
  • Includes templates and examples for writing product-ready stories quickly
SkillUser Story Writer
Made byDean Peters (PM)
CategoryProduct Management
SourceView original ↗