SkillsAdd

flpbalada/fb-skills

user-story-fundamentals

Write clear user stories with user, capability, benefit, and testable acceptance criteria.

First seen May 4, 2026

Installation

$ npx skills add flpbalada/fb-skills --skill user-story-fundamentals
View on skills.sh ↗ GitHub repository ↗

Summary

  • Write clear user stories with user, capability, benefit, and testable acceptance criteria.
  • Use when creating or improving backlog items, Given/When/Then criteria, INVEST checks, and user-centered requirements; avoid for roadmap hierarchy, broad requirement audits, or effort sizing.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
langgraph-fundamentals Similar name
langchain-ai/langchain-skills

INVOKE THIS SKILL when writing ANY LangGraph code. Covers StateGraph, state schemas, nodes, edg…

14.5K installs
langchain-fundamentals Similar name
langchain-ai/langchain-skills

Create LangChain agents with create_agent, define tools, and use middleware for human-in-the-lo…

14.2K installs

Also in this package

Other skills from flpbalada/fb-skills · top by installs.

npx skills add flpbalada/fb-skills
progressive-disclosure 35 discuss-task 25 to-prd 22 project-structure 20 code-simplifier 18 code-architecture-tailwind-v4-best-practices 18 discuss-code 17 five-whys 17 react-useeffect-avoid 17 typescript-advanced-types 16

Browse all from flpbalada/fb-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 7
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,952 B
  • docs SUMMARY.md 313 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 10 installs

SKILL.md

User Story Fundamentals

Goal

Describe who needs what and why. Make completion testable.

Story Format

As a [user type],
I want [capability],
so that [benefit].

Rules

  • Name a real user or actor.
  • Describe capability, not implementation.
  • State value in the so that clause.
  • Add acceptance criteria.
  • Keep stories small enough for one sprint.
  • Split stories that are too large, vague, or dependency-heavy.
  • Separate acceptance criteria from definition of done.

INVEST Check

  • Independent: can be delivered separately.
  • Negotiable: details can change.
  • Valuable: clear user or business value.
  • Estimable: team can size it.
  • Small: fits a sprint.
  • Testable: clear pass/fail criteria.

Acceptance Criteria

Use concrete Given/When/Then statements:

Given [context],
when [action],
then [outcome].

Cover:

  • Happy path.
  • Empty or missing data.
  • Invalid input.
  • Permission or role differences.
  • Error states.

Splitting Methods

  • Workflow step.
  • User role.
  • Data operation: create, read, update, delete.
  • Happy path then edge cases.
  • Platform or channel.
  • Permission level.
  • Release slice.

Resources

Output

As a [user],
I want [capability],
so that [benefit].

- Given [context], when [action], then [outcome].

- Dependencies:
- Non-goals:
- Estimate: