story-creation

Generate INVEST-compliant user stories from natural language needs.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/dariopalminio/agile-sddf --skill story-creation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-creation
Source: https://github.com/dariopalminio/agile-sddf/tree/main/.claude/skills/story-creation
Command: npx skills add https://github.com/dariopalminio/agile-sddf --skill story-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill translates natural language needs into precise, INVEST-aligned user stories formatted with the Gherkin-based template. It reduces ambiguity and accelerates sprint planning by enforcing a consistent structure.

Core Features & Use Cases

  • Generates complete user stories that conform to the template in assets/story-gherkin-template.md.
  • Enforces INVEST and Mike Cohn guidance to ensure independent, valuable, estimable stories with testable criteria.
  • Supports multiple input modes (free text or reference to an existing requirements document) and outputs a ready-to-use story for planning or QA review.

Quick Start

Describe a need in natural language and the skill will generate a complete INVEST-friendly user story using the Gherkin template.

Frequently Asked Questions about story-creation

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

FAQPage Schema
How do I create user stories from natural language requirements?

To create user stories from natural language, you describe a feature need in plain text and the system generates a complete, INVEST-compliant story formatted with a Gherkin template. This translates ambiguous needs into structured, testable requirements for sprint planning.

What is the INVEST principle for writing user stories?

The INVEST principle for user stories ensures they are Independent, Negotiable, Valuable, Estimable, Small, and Testable. This approach enforces Mike Cohn's guidelines to reduce ambiguity and produce ready-to-commit stories with clear acceptance criteria.

How do I format user stories with Gherkin syntax?

To format user stories with Gherkin syntax, you map natural language needs into Given-When-Then structures within a standardized template. This produces testable acceptance criteria that align with the 3 C's of story creation and INVEST guidelines.

Can I generate sprint-ready user stories from free text descriptions?

Yes, you can generate sprint-ready user stories from free text descriptions. The system supports multiple input modes including free text and existing requirements documents, outputting a structured story formatted for immediate planning or QA review.

Does this user story generator work for complex feature scenarios?

This user story generator supports product ideation and requirements refinement across simple to moderately complex features and scenarios. It enforces the 3 C's and Mike Cohn's INVEST guidelines to ensure coherent, estimable outputs for sprint planning.

What is the best way to ensure my user stories are testable and estimable?

The best way to ensure user stories are testable and estimable is applying Mike Cohn's INVEST guidelines alongside the 3 C's framework. Generating stories with a Gherkin template provides structured Given-When-Then acceptance criteria for clear QA validation.