# Generating Interactive Userstory Md > Interactive Q&A to build UserStory.md from user input. Use when the user wants to create a user story document or start the assisted workflow. Use when this capability is needed. - Skill: `tomevault-io/generating-interactive-userstory-md` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/generating-interactive-userstory-md` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/generating-interactive-userstory-md/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/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 ``` --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/qte77) — claim your Tome and manage your conversions.