create-prd
$
npx mdskill add richtabor/agent-skills/create-prdDrafts feature PRDs after clarifying user requirements.
- Helps teams define scope and acceptance criteria for new features.
- Depends on user input and structured question-answer interactions.
- Decides content by analyzing feature intent and requested constraints.
- Delivers a formatted markdown document with goals and technical notes.
SKILL.md
.github/skills/create-prdView on GitHub ↗
--- name: create-prd description: Plan features interactively. Asks clarifying questions, then generates a detailed PRD document. --- # Create PRD Generate a Product Requirements Document through interactive planning. ## Process ### 1. Understand the Feature Read the user's feature request. If unclear, ask for a brief description. ### 2. Ask Clarifying Questions Ask 3-5 clarifying questions to understand scope and requirements. Format with lettered options: ``` 1. Who is the primary user? A) Logged-in users only B) All visitors C) Admin users 2. Should this persist across sessions? A) Yes, save to database B) No, session only ``` User can respond with combinations like "1A, 2B". ### 3. Generate PRD After answers, create a detailed PRD with these sections: ```md # PRD: [Feature Name] ## Introduction Brief overview of the feature and why it's needed. ## Goals - Primary goal - Secondary goals ## User Stories ### [Story Title] **Description:** As a [user], I want [action] so that [benefit]. **Acceptance Criteria:** - [ ] Specific, verifiable criterion - [ ] Another criterion - [ ] Typecheck passes - [ ] (UI changes) Verify in browser ## Functional Requirements 1. Requirement one 2. Requirement two ## Non-Goals What this feature explicitly won't do. ## Design Considerations UI/UX notes, mockup descriptions. ## Technical Considerations Architecture notes, dependencies, potential challenges. ## Success Metrics How to measure if this feature is successful. ## Open Questions Any unresolved decisions. ``` ### 4. Save PRD Save to `prds/[feature-name].md` (create `prds/` directory if needed). ``` PRD saved to prds/[feature-name].md Next: Run /create-prd-json to convert to executable format. ``` ## Guidelines - Be explicit and unambiguous - Write for junior developers and AI agents - Avoid jargon - Number requirements for easy reference - Acceptance criteria must be verifiable, not vague - Good: "Button displays 'Save' text" - Bad: "Button looks good"
More from richtabor/agent-skills
- accessibility-reviewReviews UI for accessibility issues against WCAG 2.1/2.2 AA. Triggers on "is this accessible?", "check accessibility", or contrast/a11y review requests.
- fresh-eyesRe-reads code you just wrote with fresh perspective to catch bugs, errors, and issues. Use after completing a feature, fixing a bug, or any code changes. Triggers on "review my code", "fresh eyes", "check for bugs", "did I miss anything", or "sanity check".
- motion-designProvides motion design guidance for UI components. Triggers on animation requests ("animate this", "add transition", "motion for"), refinement requests ("clean up this animation", "clean up the motion", "this feels too fast/slow", "make this feel more alive/natural"), and questions about easing, timing, or micro-interactions.
- og-imagesGuides creation of OpenGraph and Twitter share images using next/og ImageResponse. Covers layout patterns, custom fonts, avatars, title case, and Satori rules. Use when building OG images, Twitter cards, or social previews.
- ralph-github-create-issuesConverts a PRD markdown file into GitHub Issues (parent + sub-issues) for ralph-github-start-loop to execute. Use when user wants to push PRD stories to GitHub Issues.
- ralph-github-start-loopRuns autonomous loop fetching stories from GitHub Issues. Implements and closes issues as done. Triggers on "loop through my PRDs", "work on my issues", "start the autonomous loop", "implement my PRDs", or requests to work through GitHub issues autonomously.
- ralph-json-create-issuesConverts a PRD or plan markdown file into prd.json format for ralph-json-start-loop to execute autonomously. Use when user wants to convert a PRD or plan to JSON stories.
- ralph-json-start-loopRuns the Ralph autonomous loop. Executes stories from prds/*.json using git worktrees.
- red-pen>
- review-agents-mdCreates minimal, effective AGENTS.md files using progressive disclosure. Triggers on "create agents.md", "refactor agents.md", "review my agents.md", "claude.md", or questions about agent configuration files. Also triggers proactively when a project is missing AGENTS.md.