# Generating Interactive Userstory Md

> Build UserStory.md interactively via Q&A. Use when the user wants to create a user story document or start the assisted workflow.

- Skill: `qte77-claude-code-utils/generating-interactive-userstory-md` (Agent Skill)
- Install (CLI): `npx skillmds@latest add qte77-claude-code-utils/generating-interactive-userstory-md`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qte77-claude-code-utils/generating-interactive-userstory-md/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: qte77 (https://skillmd.com/u/qte77-claude-code-utils)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qte77-claude-code-utils/generating-interactive-userstory-md

---


# User Story Builder

Interactively builds `docs/UserStory.md` through structured Q&A with the user.

## Purpose

Guides users through creating a user story document that can be transformed into PRD.md using the `generating-prd-md-from-userstory-md` skill.

## Workflow

1. **Check for existing UserStory.md**
   - If exists, ask user if they want to rebuild (backup as `docs/UserStory.md.bak`)

2. **Ask structured questions** using AskUserQuestion tool for each template section:
   - Project name
   - Problem statement
   - Target users
   - Value proposition
   - User stories (use "As a [role], I want to [action] so that [benefit]" format)
   - Success criteria
   - Constraints
   - Out of scope

3. **Generate UserStory.md**
   - Read template from `ralph/docs/templates/userstory.md.template`
   - Replace placeholders with user responses
   - Write to `docs/UserStory.md`

4. **Suggest next step**: `make ralph_prd_md` to generate PRD.md

## Template

See `ralph/docs/templates/userstory.md.template` for structure and placeholders.

## Usage

```bash
make ralph_userstory
```