Skip to main content
skill CX Codex

writing-user-stories — Claude Code skill: user story format

writing-user-stories — a skill that teaches agents to write user stories in standard format: persona, action, and benefit. Triggers when you need to define requirements from the user's perspective.

MIT 1 installs ★ 296 updated 2026-01-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code
Open on GitHub

What writing-user-stories does

User stories break down requirements into three parts: who performs the action (persona), what they do (action), and why it matters (benefit). The format is formulaic: “As a PERSONA I want to DESCRIPTION_OF_ACTION So that DESCRIPTION_OF_BENEFIT”. This structure makes requirements clear and testable.

The skill runs on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Use it when planning features, refining requirements, or asking an agent to generate a set of stories for a project. An agent working from this skill focuses on user needs rather than just technical implementation.

Installation varies by platform. For Claude Code, run npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code. For GitHub Copilot, use gh skill install nicepkg/ai-workflow writing-user-stories. After setup, the skill loads into the agent's context and activates when you ask for user stories.

What it helps with

  • Define requirements from a user's perspective instead of technical specs
  • Generate user stories for a new feature or epic
  • Ensure each story is clear enough to test and estimate

Example prompts for the agent

  • Write user stories for an export-to-PDF feature
  • Help me plan this feature using the writing-user-stories skill
  • Convert this technical spec into a set of user stories

How to install writing-user-stories

1Skills CLI (Vercel)

npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code

2Manually: put the files in place

~/.claude/skills/writing-user-stories/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/writing-user-stories/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about writing-user-stories

How do I install writing-user-stories in Claude Code?

Run npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code. The skill loads into ~/.claude/skills/writing-user-stories/SKILL.md and is available to your agent on the next run.

What does writing-user-stories do?

It teaches agents to write user stories in standard form: as a persona, I want to do X so that Y. This clarifies feature requirements and makes planning and estimation more straightforward.

Which platforms support writing-user-stories?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Installation steps differ: use npx skills add for Claude Code and gh skill install for GitHub Copilot.

Source text

SKILL.md · MIT
---
name: writing-user-stories
description: Use when an agent needs to write user stories for a project
---

# Writing User Stories

## Overview

Help Claude and subagents write properly formatted user stories for task definition.

**Core principle:** User stories are formulaic ways of expressing user requirements. They identify the perosna of the actor, what they want to do, and what benefit are they hoping to gain from their actions.

## When to Use This Skill

Use this skill when:
- You are asked to write a user story
- You are asked to plan a feature

## User Story Format

As a PERSONA
I want to DESCRIPTION_OF_ACTION
So that DESCRIPTION_OF_BENEFIT.

### Examples

As a non-technical stakeholder, 
I want to understand what changed in a release without reading code diffs 
so that I can communicate updates to customers effectively.

As a new user, 
I want to see examples of AI-generated code before connecting my repository 
so that I understand the value proposition before committing to integration.

As a home cook,
I want to see that recipes have been tested by professional chefs
so that I can know whether they are worth trying.

© nicepkg · MIT · nicepkg/ai-workflow

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set2

Project sponsors

Companies that keep this analytics open