Agent skill
skill-prd
AI-optimized PRD creation with 100-point scoring framework
Install this agent skill to your Project
npx add-skill https://github.com/nyldn/claude-octopus/tree/main/skills/skill-prd
SKILL.md
STOP - SKILL ALREADY LOADED
DO NOT call Skill() again. DO NOT load any more skills. Execute directly.
PHASE 0: CLARIFICATION (MANDATORY)
Before writing ANY PRD content, you MUST ask the user these questions:
I need to understand your requirements before creating the PRD.
1. **Target Users**: Who will use this? (developers, end-users, admins, etc.)
2. **Core Problem**: What specific pain point does this solve? Any metrics?
3. **Success Criteria**: How will you measure if this succeeds?
4. **Constraints**: Any technical, budget, or timeline constraints?
5. **Existing Context**: Is this greenfield or integrating with existing systems?
Please answer these (even briefly) so I can create a more targeted PRD.
WAIT for user response before proceeding to Phase 1.
If user says "skip" or provides the feature description inline, extract what you can and note assumptions.
PHASE 1: QUICK RESEARCH (Max 2 searches)
Only search if topic is unfamiliar. Limit to 2 web searches max:
- One for domain/market context
- One for technical patterns (if needed)
Do NOT over-research. 60 seconds max for this phase.
PHASE 2: WRITE PRD
Structure:
- Executive Summary - Vision + key value prop
- Problem Statement - Quantified pain points by user segment
- Goals & Metrics - SMART goals, P0/P1/P2 priority, success metrics table
- Non-Goals - Explicit boundaries (what we WON'T do)
- User Personas - 2-3 specific personas with use cases
- Functional Requirements - FR-001 format with acceptance criteria
- Implementation Phases - Dependency-ordered, time-boxed
- Risks & Mitigations - Top 3-5 risks with mitigation strategies
PHASE 2.5: ADVERSARIAL PRD REVIEW (RECOMMENDED)
After drafting the PRD but BEFORE self-scoring, dispatch the draft to a second provider for adversarial review. A single-model PRD has blind spots — cross-provider challenge surfaces wrong assumptions, uncovered scenarios, and contradictory requirements.
Dispatch the PRD draft to a different provider (Codex, Gemini, or Sonnet as fallback) with this prompt:
"Challenge this PRD. What assumptions are wrong? What user scenarios are missing? What requirements contradict each other? What will the first user complaint be? What risk does this PRD ignore?"
After receiving the challenge:
- Revise the PRD to address valid challenges
- Note dismissed challenges in the Risks section if they have partial merit
- Add to PRD footer:
Adversarial review: applied
Skip with --fast or when user requests speed over thoroughness. See prd.md command for full dispatch syntax.
PHASE 3: SELF-SCORE
Score against 100-point framework:
- AI-Specific Optimization: 25 pts (sequential phases, non-goals, structured format)
- Traditional PRD Core: 25 pts (problem statement, goals, personas, specs)
- Implementation Clarity: 30 pts (FRs with codes, NFRs, architecture, phases)
- Completeness: 20 pts (risks, dependencies, examples, doc quality)
PHASE 4: SAVE
Write to user-specified filename or generate based on feature name.
START WITH PHASE 0 CLARIFICATION QUESTIONS NOW.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
skill-iterative-loop
Run tasks in a loop until goals are met — use for iterative refinement, polling, or convergence. Use when: AUTOMATICALLY ACTIVATE when user requests iterative execution:. "loop X times" or "loop around N times". "loop around 5 times auditing, enhancing, testing"
skill-context-detection
Auto-detect work context (Dev vs Knowledge) for workflow tailoring
skill-code-review
Expert multi-AI code review with quality and security analysis
skill-doc-sync
Post-ship doc sync across project markdown. Use when: "sync docs", "update docs", "document changes", "release notes".
skill-meta-prompt
Craft better prompts using proven optimization techniques — use when your prompt needs refinement. Use when: Use PROACTIVELY when user wants to:. "create a prompt for", "write a prompt for". "optimize this prompt", "improve this prompt"
octopus-quick
Quick execution for ad-hoc tasks without workflow overhead. Use when: Use this skill when user says "quick fix", "ad-hoc task", or explicitly. requests fast execution without full workflow overhead.
Didn't find tool you were looking for?