pm-user-story

pm-user-story is a skill for Claude Code from Uxcel-Lab/product-skills. It costs 140 tokens per session (2,488 once invoked), scanned A, original, MIT.

A small requirement written around a real person's need: who they are, what they need, and why it matters. It describes user value rather than simply naming a feature or task.

In plain words
What is it for?
Use it to write or review user stories, connect them across a user's journey, and decide whether acceptance criteria or smaller stories are needed.
Why use it?
It stops requirements from becoming task lists and gives a team a small, testable shared understanding of the user's goal.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the uxcel plugin — 58 skills shipped together

Good fit Use it to write or review user stories, connect them across a user's journey, and decide whether acceptance criteria or smaller stories are needed.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/uxcel-lab/product-skills/user-story
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Uxcel-Lab/product-skills --skill user-story
Clone the repo
git clone --depth 1 https://github.com/Uxcel-Lab/product-skills

Made for: Claude Code.

Or install uxcel, the plugin that ships this one along with the rest of its 58 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pm-user-story

README.md
[![agentmods](https://agentmods.dev/badge/skills/uxcel-lab/product-skills/user-story/github.svg)](https://agentmods.dev/skills/uxcel-lab/product-skills/user-story)
Your own site
<a href="https://agentmods.dev/skills/uxcel-lab/product-skills/user-story"><img src="https://agentmods.dev/badge/skills/uxcel-lab/product-skills/user-story/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pm-user-story

Your own site · 80×15
<a href="https://agentmods.dev/skills/uxcel-lab/product-skills/user-story"><img src="https://agentmods.dev/badge/skills/uxcel-lab/product-skills/user-story.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 140 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,488 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00140 $0.02488
Opus 5 $0.00070 $0.01244
Sonnet 5 $0.00028 $0.00498
Haiku 4.5 $0.00014 $0.00249

Measured 11d ago against content hash b7199d076dd7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

pm-user-story scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

pm/foundations/user-story/SKILL.md · 99 lines

How it starts

The opening of the file, as written. The whole thing — 99 lines — stays where its author put it; the contents beside it link to each section on GitHub.

User Story Skill

How this skill behaves (read first)

This is a generative skill, and user stories are where requirements quietly turn back into a task list. The default move is to restate a feature as a story — "Add login feature," or the hollow "As a user, I want a button so I can submit" — describing what to build instead of who needs what and why. A real user story is a small, testable unit of user value, grounded in a real persona's need, that gives the team a shared who/what/why — and the discipline to not write one when it adds nothing the spec already says. So this skill gates:

  1. Establish whose need this is, whether it's real, and what the story feeds — a story with no grounded user is an assumption in costume.
  2. Apply the always-true core — frame from user value, keep the story small with detail pushed to acceptance criteria, make it INVEST/testable, map stories across the journey, and cut stories that add no clarity.
  3. Surface the context-dependent decisions (strict formula vs. free-form, write-a-story-at-all, acceptance-criteria depth, splitting into a map, communication framing) with trade-offs.

Then it hands off to pm-spec-quality-audit (which flags task-stories, untestable stories, and broken traceability) and pm-assumption-rigor-audit (is the user need evidenced or assumed?).

Scope: this skill owns the user-story artifact. It defers building the persona to pm-personas-jtbd, framing the underlying problem to pm-problem-statement, and the full spec/PRD and acceptance-criteria depth to pm-product-spec (audited by pm-spec-quality-audit). Agile ceremonies, backlog grooming, and sprint mechanics are out of scope.


Step 0 — Establish context before writing stories

Ask if not known; state the assumption if proceeding without an answer:

  • Whose need is this, and is it real? A story starts from a research-grounded persona and a validated need — "As Maria, who has no time to configure settings…" beats "users prefer automation." If the persona or need is assumed, say so; an ungrounded story propagates the assumption into the backlog. (Build the persona in pm-personas-jtbd.)
  • How complex is the need? A single discrete need fits the "As a [persona], I want [action], so that [benefit]" formula; a feature spanning multiple user types or layered benefits may need to be split or written free-form.
  • Does a story add clarity the PRD/spec doesn't already have? If the team gets full context elsewhere, a story is documentation for its own sake. Write it only when it earns its place.
  • What does it feed? A backlog, a spec, or an imminent sprint — this sets how much acceptance-criteria detail to attach now.

Read the full file on GitHub · 99 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 99 lines · 140 tokens per session scan A b7199d076dd7

Subscribe to this mod's changes

pm-user-story is a skill published in the GitHub repository Uxcel-Lab/product-skills (10 stars, last pushed 2mo ago), licensed MIT. It adds 140 tokens to every session and 2,488 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

azure-devops

Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments. Use when user asks to: manage sprints, create/update work items, list repos, create PRs, run pipelines, search code, manage wiki pages, check…

sanjay3290/ai-skills · 105 tokens

atlassian

Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Use when: (1) searching/creating/updating Jira issues with JQL, (2) searching/reading/creating Confluence pages with CQL, (3) managing Jira workflows, transitions, and comments, (4) browsing Confluence spaces and page hierarchies. Supports OAuth 2.1 via…

sanjay3290/ai-skills · 96 tokens

pm-brainstorm

A guided brainstorming workflow for exploring a new product idea before detailed research or requirements work. It collects basic information about the product, users, and problem through staged questions.

konglong87/superPM · 123 tokens

start-super-pm

Use when starting any product management task - automatically detects task type and invokes appropriate PM skill using intelligent routing.

konglong87/superPM · 25 tokens

pm-priority

A Chinese-language procedure for ranking several product requests when time or resources are limited. It supports scoring or grouping methods such as RICE, KANO, and MoSCoW to decide what should be done first.

konglong87/superPM · 59 tokens

pm-change

A requirements-change workflow for recording a proposed change, assessing its effects, and deciding whether to approve it.

konglong87/superPM · 54 tokens