write-story

Generates user stories with acceptance criteria and validates them using INVEST criteria.

4|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/cpliakas/claude-code-engineering-leaders --skill write-story-cpliakas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-story
Source: https://github.com/cpliakas/claude-code-engineering-leaders/tree/main/skills/write-story
Command: npx skills add https://github.com/cpliakas/claude-code-engineering-leaders --skill write-story-cpliakas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the creation of high-quality user stories, ensuring they are well-defined, meet INVEST criteria, and are ready for development.

Core Features & Use Cases

  • Automated Story Drafting: Generates user stories with titles, bodies, and acceptance criteria based on provided descriptions.
  • INVEST Validation: Automatically checks stories against the Independent, Negotiable, Valuable, Estimable, Small, and Testable criteria.
  • Contextual Refinement: Reads project context (CLAUDE.md, roadmaps) to inform story details and technical notes.
  • Use Case: You have a feature idea like "add CSV export to audit log". This Skill will turn that into a complete user story with clear acceptance criteria and technical considerations, ready for your backlog.

Quick Start

Use the write-story skill to draft a user story for adding CSV export to the audit log page.

Frequently Asked Questions about write-story

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

FAQPage Schema
How do I write user stories with acceptance criteria from a feature description?

To write user stories with acceptance criteria, input your feature description and project context. The system automatically drafts a structured user story with clear titles, bodies, and testable acceptance criteria ready for development.

What is INVEST validation in agile story writing?

INVEST validation in agile story writing checks if a user story is Independent, Negotiable, Valuable, Estimable, Small, and Testable. The system automatically validates your stories against these criteria to ensure they are ready for backlog refinement.

How do I refine incomplete user stories for my project backlog?

To refine incomplete user stories, the system reads project context like roadmaps and CLAUDE.md files, then prompts you for underspecified dimensions. This contextual refinement ensures stories are actionable and technically informed before development.

Can I generate agile user stories that include technical notes and project context?

Yes, you can generate agile user stories that include technical notes. By analyzing your project context and feature descriptions, the tool incorporates relevant technical considerations directly into the generated story details.

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

The best way to ensure user stories are small and testable is using automated INVEST validation. This process checks each story against specific criteria, prompting iterative refinement until the story is properly sized and testable.

Does automated story writing support iterative refinement for underspecified features?

Yes, automated story writing supports iterative refinement. It performs automated checks on your feature descriptions and actively prompts you to clarify underspecified dimensions, ensuring the final user story is fully actionable.