Skip to content
cccskills
FreePublished on GitHub

skill-prd

Create a product requirements document for a new feature or product. Clarify users, problems, goals, and constraints, then organize prioritized requirements, acceptance criteria, implementation phases, and risks into a structured document for AI-assisted development.

OriginalShow the original description

Write an AI-optimized PRD using multi-AI orchestration — use when scoping a new feature or product

See how to install

Good for

  • Defining the scope of a new feature
  • Turning a product idea into written requirements
  • Documenting acceptance criteria and priorities
  • Checking requirements for gaps and contradictions

Files included (2)

  • SKILL.md3.6 KB
  • agents/openai.yaml161 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Host: Codex CLI — This skill was designed for Claude Code and adapted for Codex. Cross-reference commands use installed skill names in Codex rather than /octo:* slash commands. Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it. For host tool equivalents, see skills/blocks/codex-host-adapter.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:

  1. Executive Summary - Vision + key value prop
  2. Problem Statement - Quantified pain points by user segment
  3. Goals & Metrics - SMART goals, P0/P1/P2 priority, success metrics table
  4. Non-Goals - Explicit boundaries (what we WON'T do)
  5. User Personas - 2-3 specific personas with use cases
  6. Functional Requirements - FR-001 format with acceptance criteria
  7. Implementation Phases - Dependency-ordered, time-boxed
  8. 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, Antigravity, 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

council-verdicts

FreeSummary

Interpret the saved results of a completed AI council review. Count verdicts, check whether enough participants responded and whether models are independent, surface substantive dissent, and explain what action the outcome supports.

  • Explain a completed council review
  • Check vote counts and quorum
  • Assess model independence and dissent
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

debate-kickoff

FreeSummary

Turn a technical choice into a structured debate between different AI model families. Assign explicit positions, launch the discussion, and summarize agreement, disagreement, and a recommendation supported by the strongest argument that survives the debate.

  • Compare Redis and Memcached for session storage
  • Debate monorepo versus polyrepo organization
  • Examine a technical choice from opposing positions
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

flow-define

FreeSummary

Clarify a feature’s requirements with multiple AI providers, combining technical constraints with user and business needs. Produce a scoped definition covering priorities, edge cases, exclusions, and a requirements checklist before implementation begins.

  • Defining requirements for a user authentication system
  • Setting boundaries for a notification feature
  • Identifying technical constraints and edge cases
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

flow-deliver

FreeSummary

Review code or documents with available AI providers before delivery. Combine findings into a scored validation report that checks prior requirements and decisions, separates critical issues from warnings, and recommends next steps.

  • Review authentication code before release
  • Check API readiness before deployment
  • Review a PRD for missing requirements
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

flow-develop

FreeSummary

Develop complex features or business documents by gathering approaches from available AI providers. Combine their perspectives with prior project decisions and quality checks to produce a proposed plan, then proceed with implementation after user confirmation.

  • Planning and implementing a complex feature
  • Comparing approaches for an external service integration
  • Developing a product requirements document or strategy
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

flow-discover

FreeSummary

Research technical or business questions through multiple available AI providers, each assigned a different perspective. Combine usable results into a report covering findings, disagreements, evidence gaps, priorities, and recommended next steps.

  • Compare libraries and technical approaches
  • Research markets and competitor strategies
  • Synthesize literature from multiple perspectives
nyldn/claude-octopus4.3KUpdated Oct 19, 2026

See all skills by nyldn

Report a problem with this skill