Can I use this for different types of projects?

Absolutely. The skill provides specific verification approaches tailored for various project types, including CLI tools, APIs, Web UIs, Mobile apps, and Libraries.

How are stories stored and organized?

Stories are stored as Markdown files in the docs/stories/ directory using a standardized timestamp-prefixed naming convention (YYYYMMDDTHHMMSS_name.story.md) for chronological tracking.

Does this skill support Gherkin syntax?

Yes, it specifically guides the creation of acceptance criteria using the Given-When-Then format, which is the standard for Gherkin and Behavior-Driven Development (BDD).

What is the difference between an Epic and a Story in this skill?

An Epic is a design document used to define the overall scope and technical approach for large features, while a Story is an incremental deliverable with specific acceptance criteria created as needed during development.

Defining Stories

Name: Defining Stories
Author: kecbigmt

bykecbigmt

0•

Collaboration Tools

Standardizes the creation of user stories and epic design documents to streamline Story-driven Development workflows.

The Defining Stories skill integrates Agile principles directly into the Claude Code environment, enabling developers to formalize requirements and technical designs using industry-standard formats. It guides the creation of user stories using the 'As a/I want/So that' framework and facilitates the drafting of acceptance criteria via Given-When-Then (Gherkin) syntax. By managing story logs and epic design documents with specific naming conventions and verification strategies, it ensures that feature development remains scoped, testable, and documented throughout the software development lifecycle.

Key Features

01Generates standardized user stories with role-based capability and benefit statements.

02Automates the creation of timestamped story logs and structured epic directories.

030 GitHub stars

04Drafts acceptance criteria using Given-When-Then syntax for clear behavior-driven verification.

05Provides tailored verification strategies for CLI, API, Web UI, Mobile, and Library projects.

06Facilitates incremental story emergence to support flexible Agile development cycles.

Use Cases

01Defining granular, testable acceptance criteria for a specific feature enhancement.

02Drafting a comprehensive technical design document (Epic) before starting a complex feature.

03Maintaining a chronological audit trail of feature development through timestamped story logs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kecbigmt/cc-plugins defining-stories

For use in Claude.ai and ChatGPT

Download Skill