user-story-writing

Draft testable user stories with Given-When-Then templates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ctimmerman-prog/ai-config-opencodeai-first-to-others --skill user-story-writing-ctimmerman-prog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story-writing
Source: https://github.com/ctimmerman-prog/ai-config-opencodeai-first-to-others/tree/main/.cursor/skills/user-story-writing
Command: npx skills add https://github.com/ctimmerman-prog/ai-config-opencodeai-first-to-others --skill user-story-writing-ctimmerman-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps product teams convert vague ideas into concise, testable user stories that guide development and acceptance criteria.

Core Features & Use Cases

  • Template-based drafting with Given-When-Then style
  • Quick alignment with stakeholders by capturing goals, success criteria, and constraints
  • Acts as a wrapper to reference the canonical skill in .opencode/skills/user-story-writing/SKILL.md and load its guidance

Quick Start

Open and follow .opencode/skills/user-story-writing/SKILL.md to access the canonical instructions.

Frequently Asked Questions about user-story-writing

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

FAQPage Schema
How do I write clear user stories for agile development?

To write clear user stories for agile development, draft them using structured Given-When-Then templates and validation checks to ensure completeness and consistency. This converts vague product ideas into testable stories.

What is the best way to format acceptance criteria for a product feature?

The best way to format acceptance criteria is using a Given-When-Then template. This structure captures specific conditions, actions, and expected outcomes to align stakeholders and guide development.

Can I use this approach to define story points and feature scopes?

Yes, you can use this approach to define story points and feature scopes. It helps capture goals, success criteria, and constraints, allowing product teams to quickly align on the boundaries of a feature.

Does this user story drafting method work for design sprints?

Yes, this user story drafting method works for design sprints. It is applicable to product management, software engineering, and design sprints for capturing feature scopes and validation checks.

Why do my agile user stories lack testable acceptance criteria?

Agile user stories lack testable acceptance criteria when vague ideas are not converted into structured formats. Applying Given-When-Then templates and validation checks ensures stories are complete and testable.