writing-agile-stories

Write narrative user stories with Given-When-Then acceptance criteria.

5|1|Updated Sep 6, 2009
One-click install
npx skills add https://github.com/bnadlerjr/dotfiles --skill writing-agile-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-agile-stories
Source: https://github.com/bnadlerjr/dotfiles/tree/main/claude/skills/writing-agile-stories
Command: npx skills add https://github.com/bnadlerjr/dotfiles --skill writing-agile-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Writing clear, behavior-focused user stories that articulate user needs without prescribing implementation, enabling better communication and testability.

Core Features & Use Cases

  • Narrative-first Storycraft: Produce stories focused on observable user behavior rather than technical steps.
  • Given-When-Then Acceptance Criteria: Generate testable criteria aligned with business language.
  • Discovery & Review Guidance: Include structured prompts and quality checks to ensure stories are small, independent, and ready for validation.

Quick Start

Describe a real user need in 2-4 sentences and provide a Given-When-Then scenario.

Frequently Asked Questions about writing-agile-stories

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

FAQPage Schema
How do I write agile user stories that focus on behavior instead of implementation?

To write behavior-focused agile user stories, describe the user's problem and desired behavior in plain business language using a narrative format. This ensures stories remain independent, testable, and free of technical implementation steps.

What is the Given-When-Then format for agile acceptance criteria?

Given-When-Then acceptance criteria structure testable conditions by defining a starting context, an action, and the expected observable behavior. This format aligns directly with business language and supports downstream validation and testing.

How do I structure agile story discovery and review phases?

Structure agile story discovery and review by using structured prompts and quality checks to ensure narratives are small, independent, and ready for validation. This process enforces business language usage and verifies explicit failure modes are mapped.

Can I use BDD narrative stories for both planning and testing?

Yes, BDD narrative stories support both planning and testing by mapping observable user behaviors to downstream validation. Writing stories in plain business language ensures they are directly testable and align with agile planning phases.

Why should agile user stories avoid prescribing technical steps?

Agile user stories should avoid prescribing technical steps to ensure they articulate user needs clearly and remain testable. Focusing on observable behavior rather than implementation enables better communication across the team.

What are the limitations of narrative-form agile story writing?

Narrative-form agile story writing requires strict adherence to business language and independence of scenarios. It may not suit teams needing heavy technical specification, as it deliberately abstracts implementation details to focus purely on user behavior.