skills.rest
panaversity
panaversityOFFICIAL
Explore all skills by this author →
GitHub

stories

Convert specs or PRDs into named-persona user stories with testable acceptance criteria.

28|19|Updated Mar 5, 2026
Search Tags:#persona#prd#stories#sprint#acceptance-criteria#story-writing#spec-to-stories
One-click install
npx skills add https://github.com/panaversity/agentfactory-business-plugins --skill stories-panaversity
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stories
Source: https://github.com/panaversity/agentfactory-business-plugins/tree/main/product-strategy/skills/stories
Command: npx skills add https://github.com/panaversity/agentfactory-business-plugins --skill stories-panaversity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams convert vague specs and PRDs into concrete, named-persona user stories that are ready for development, ensuring clarity and testability from the start.

Core Features & Use Cases

  • Automatically derive As a [Persona], I want to [capability], So that [outcome] stories from a given spec or PRD.
  • Enforce Acceptance Criteria formatting: each AC is testable, uses Given/When/Then where possible, and avoids compound statements.
  • Flag coverage gaps and unusable ACs to keep the backlog complete and sprint-ready.
  • Ensure stories align with sprint goals by sizing and grouping by distinct user flows and personas.

Quick Start

Provide a set of named-persona user stories derived from the input spec for sprint planning.

Frequently Asked Questions about stories

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a PRD into user stories for sprint planning?▼

To convert a PRD into user stories, translate the spec into 'As a [Persona], I want to [capability], So that [outcome]' statements grouped by user flow. This ensures each story is sprint-completable with independent, testable acceptance criteria.

What is the best way to write acceptance criteria that are testable?▼

The best way to write testable acceptance criteria is to use Given/When/Then formatting while avoiding compound statements with 'and'. This ensures each criterion is independent and can be verified as a distinct test case during development.

How do I identify coverage gaps when translating specs to user stories?▼

To identify coverage gaps when translating specs, review the generated user stories for missing flows or unusable acceptance criteria. Flagging these gaps keeps the backlog complete and ensures all requirements are expressible as testable stories.

Can I use named personas in user stories derived from a spec?▼

Yes, you can use named personas in user stories by referencing a defined product.local.md or a reasonable named alternative. This ensures translated specs group capabilities by distinct user flows and specific persona identities.

Why should user stories be completable in one sprint?▼

User stories should be completable in one sprint to align with sprint goals and ensure manageable development scope. Sizing stories by distinct user flows and personas keeps the backlog sprint-ready and delivery predictable.

Related Skills

Explore More Product & Management Skills→
becerra-albertobecerra-alberto
4

ralph

Convert Product Requirements Documents into Ralph v2 story specifications and queue files.

Community
Intermediate
inho-teaminho-team
6

Qpm-user-story

Translate user needs into INVEST-form user stories with Gherkin acceptance criteria.

Official
Intermediate
mcauduro0mcauduro0
1

agile-product-owner

Generate user stories and plan sprints with Python scripts.

Community
Intermediate
product-on-purposeproduct-on-purpose
527

deliver-user-stories

Generate user stories and Given/When/Then acceptance criteria from product requirements.

Official
Basic