story-writing

Generate INVEST-compliant user stories with acceptance criteria and splitting strategies.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/bdbch/ai-dotfiles --skill story-writing-bdbch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-writing
Source: https://github.com/bdbch/ai-dotfiles/tree/main/skills/story-writing
Command: npx skills add https://github.com/bdbch/ai-dotfiles --skill story-writing-bdbch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps streamline the process of creating and refining user stories, ensuring they are clear, actionable, and valuable.

Core Features & Use Cases

  • User Story Creation: Guides the creation of user stories using the INVEST criteria and provides templates for effective storytelling.
  • Acceptance Criteria: Offers a structured approach to defining acceptance criteria with examples and best practices.
  • Story Splitting: Provides strategies for splitting large stories into manageable parts for better iteration management.
  • Story Mapping: Helps organize stories into a roadmap for feature development and release planning.
  • Refinement: Offers a checklist to ensure stories are ready for development, including format, size, dependencies, and design considerations.

Quick Start

Use the story-writing skill to create a user story for your next feature.

Frequently Asked Questions about story-writing

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

FAQPage Schema
How do I write user stories that meet the INVEST criteria?

To write user stories with the INVEST criteria, provide clear and concise feature input to generate stories that are Independent, Negotiable, Valuable, Estimable, Small, and Testable, ensuring they are actionable and well-defined.

What is the best way to define acceptance criteria for a user story?

Defining acceptance criteria uses a structured approach with examples and best practices to establish clear, testable conditions that verify the user story functionality meets expectations.

How do I split large user stories for better iteration management?

Split large user stories by applying provided story splitting strategies that break down oversized items into manageable parts, enabling better iteration management and incremental feature delivery.

Can I use story mapping to organize features into a release roadmap?

Yes, story mapping organizes user stories into a structured roadmap for feature development and release planning, helping sequence tasks and visualize the product backlog effectively.

What should a user story refinement checklist include before development?

A user story refinement checklist includes verifying story format, assessing story size, identifying dependencies, and evaluating design considerations to ensure the story is ready for development.

Does user story creation work for both product managers and software developers?

Yes, user story creation is optimized for both product managers and software developers, providing a collaborative framework to create well-defined, actionable user stories that align development with product value.