story-craftsman

Generate INVEST-compliant user stories and place them in standardized project directories.

42|7|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/addxai/enterprise-harness-engineering --skill story-craftsman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-craftsman
Source: https://github.com/addxai/enterprise-harness-engineering/tree/main/skills/story-craftsman
Command: npx skills add https://github.com/addxai/enterprise-harness-engineering --skill story-craftsman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the common pain points of incomplete, vague user stories and disorganized project documentation that lead to requirement misalignment, unclear acceptance criteria, and wasted development time.

Core Features & Use Cases

  • Guided User Story Generation: Uses a structured interview protocol to extract missing requirement context (background, goals, acceptance criteria) and generates INVEST-compliant user story documents, eliminating vague or incomplete requirements.
  • Automated Document Placement: Infers the target project sub-module from file paths or git status to place generated user stories in the correct docs/04-user-stories/ directory, avoiding manual file organization errors.
  • Standard Docs Structure Initialization: Creates the full 5-folder standard project documentation directory structure with .gitkeep files and maintenance guidelines for new projects, ensuring consistent documentation organization across teams. Use case: For example, when a product team needs to document a new alarm filtering feature, the skill guides stakeholders to clarify pain points (500+ daily heartbeat probe alarms causing operator alert fatigue), quantifiable success metrics (reduce fault response time from 15 minutes to 2 minutes), and verifiable acceptance criteria, then saves the standardized document to the correct operations module docs folder.

Quick Start

Ask the story-craftsman skill to help you write a user story for the new alarm silence rule feature, and it will guide you through confirming missing requirements and generate the standardized document in the correct project directory.

Frequently Asked Questions about story-craftsman

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

FAQPage Schema
How do I write INVEST-compliant user stories with verifiable acceptance criteria?

To write INVEST-compliant user stories with verifiable acceptance criteria, use a structured interview protocol to extract requirement context like background, goals, and quantifiable success metrics. This eliminates vague requirements by generating standardized documents with clear acceptance criteria.

What is the best way to initialize a standardized project documentation directory structure?

The best way to initialize a standardized project documentation directory structure is to generate the full 5-folder standard hierarchy with .gitkeep files and maintenance guidelines. This ensures consistent documentation organization across teams for new projects.

How does automated document placement work for user stories in project modules?

Automated document placement for user stories works by inferring the target project sub-module from file paths or git status. It then saves generated requirement documents into standardized module-specific directories like docs/04-user-stories/, avoiding manual file organization errors.

Can I use this tool to fix incomplete requirement documentation before development starts?

Yes, you can fix incomplete requirement documentation before development by applying a guided generation process. It clarifies pain points and quantifiable metrics, producing standardized user story documents that prevent requirement misalignment and wasted development time.

Does generating user stories require any specific dependencies or environments?

Generating user stories requires no specific dependencies. The skill operates independently within software development and product management environments to produce standardized requirement documentation and initialize project docs.

What are the limitations of using structured interview protocols for requirement documentation?

The limitation of using structured interview protocols for requirement documentation is that it requires stakeholders to provide clear background context and quantifiable goals. Without active stakeholder input to clarify missing requirements, the generated user story may lack the necessary verifiable acceptance criteria.