Agent skill

prd-creator

Guides creation of comprehensive Product Requirement Documents (PRDs) for software projects through structured questioning and validation, then generates implementation task lists in JSON format. Use when users want to document a software idea, create specifications for development, plan a new application feature/bug, or break down requirements into actionable tasks. Transforms ideas into implementation-ready documents with verifiable pass criteria.

Stars 193
Forks 28

Install this agent skill to your Project

npx add-skill https://github.com/PageAI-Pro/ralph-loop/tree/main/.agent/skills/prd-creator

Metadata

Additional technical details for this skill

tags
prd, product requirements, software development, documentation, task generation
author
pageai
version
1.0.1

SKILL.md

PRD Creation Assistant

Transform software ideas into comprehensive PRDs and actionable implementation tasks through a two-part process.

Overview

This skill helps beginner-level developers.

  1. Receive an implementation description from the user
  2. Create detailed PRD documents through structured questioning
  3. Generate implementation task lists in JSON format for developers
  4. Write an overall description of the project. An executive summary that gives a high level overview of the app and its main features.

Part 1: Implementation Description

You will receive a lacking implementation description from the user. The main goal is to comprehend the intent and think about the larger architecture and a robust way to implement it, filling in the gaps.

Part 2: PRD Creation

File: PRD.md

You will need to ask clarifying questions to get a clear understanding of the implementation.

When to use: User wants to document a software idea or create feature specifications

What it does:

  • Guides structured questioning to gather all requirements
  • Creates executive summary for validation
  • Researches competitive landscape
  • Generates comprehensive PRD.md with:
    • App overview and objectives
    • Target audience
    • Success metrics and KPIs
    • Competitive analysis
    • Core features and user flows
    • Technical stack recommendations
    • Security considerations
    • Assumptions and dependencies

Process:

  1. Ask clarifying questions using AskUserQuestion tool
  2. Create executive summary for user approval
  3. Research competition via WebSearch
  4. Generate complete PRD
  5. Iterate based on feedback

Read PRD.md for complete instructions.


Part 3: Implementation Task Generation

File: JSON.md

You will need to analyze the completed PRD and generate a comprehensive task list in JSON format.

When to use: After PRD is complete and approved, or user requests task breakdown

What it does:

  • Analyzes the completed PRD
  • Generates a complete list of implementation tasks in JSON format, covering all features and requirements from the PRD
  • Keeps the tasks small and manageable
  • Categorizes tasks by type (functional, ui-ux, api-endpoint, security, etc.)
  • Defines verification ('pass') steps for each task
  • Creates developer-ready checklist

IMPORTANT:

  • Each task should be simple enough to be completed in maximum 10 minutes.
  • If a task is too complex, it should be split into smaller tasks.

Read JSON.md for complete instructions.

Part 4: Overall Description

You will need to read the completed PRD and generate an overall description of the project in PROJECT_ROOT/.agent/prd/SUMMARY.md.

The description should be short, concise and contain:

  • An overall description of the project
  • The main features of the app
  • Key user flows
  • A short list of key requirements

Quick Start

If user wants to create a PRD:

  1. Read PRD.md
  2. Follow the PRD creation workflow
  3. If needed, update the overall description SUMMARY.md
  4. After PRD completion, ask: "Would you like me to generate implementation tasks? See Part 2."

If user wants implementation tasks for an existing PRD:

  1. Read JSON.md
  2. Read the PRD file
  3. Generate comprehensive task list in JSON format
  4. Save as tasks.json

If user wants both:

  1. Complete PRD creation first PRD.md
  2. Get user approval on PRD
  3. If needed, update the overall description SUMMARY.md
  4. Proceed to generate implementation tasks JSON.md

If a user want to update the PRD:

  1. Read PRD.md
  2. Update the PRD
  3. Save as PRD.md
  4. If needed, update the overall description SUMMARY.md
  5. Ask user if they want to generate implementation tasks

If a user want to update the implementation tasks:

  1. Read JSON.md
  2. Update the implementation tasks
  3. Save as tasks.json
  4. Ask user if they want to update the PRD again

If user wants to update both the PRD and the implementation tasks:

  1. Update the PRD first PRD.md
  2. If needed, update the overall description SUMMARY.md
  3. Update the implementation tasks JSON.md
  4. Save as PRD.md and tasks.json

After completion

Ensure the required files are present:

  • PROJECT_ROOT/.agent/prd/PRD.md
  • PROJECT_ROOT/.agent/prd/SUMMARY.md
  • PROJECT_ROOT/.agent/tasks.json

If they are not present, warn the user and ask if they would like to create any of them.

Important Constraints

  • Do not generate code - focus on documentation and task specification
  • Use AskUserQuestion extensively in Part 1 to clarify requirements
  • In Part 2, generate comprehensive task lists (50-200+ tasks for typical projects)
  • Always initialize tasks with "passes": false - never mark tasks complete during generation
  • Use available tools: AskUserQuestion, WebSearch, Sequential Thinking, Read

Expand your agent's capabilities with these related and highly-rated skills.

PageAI-Pro/ralph-loop

frontend-testing

Generate Vitest + React Testing Library tests for frontend components, hooks, and utilities. Triggers on testing, spec files, coverage, Vitest, RTL, unit tests, integration tests, or write/review test requests.

193 28
Explore
PageAI-Pro/ralph-loop

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

193 28
Explore
PageAI-Pro/ralph-loop

frontend-code-review

Trigger when the user requests a review of frontend files (e.g., `.tsx`, `.ts`, `.js`). Support both pending-change reviews and focused file reviews while applying the checklist rules.

193 28
Explore
PageAI-Pro/ralph-loop

component-refactoring

Refactor high-complexity React components in frontend. Use when the user asks for code splitting, hook extraction, or complexity reduction, or when you come across a component that is too complex to understand and refactor it.

193 28
Explore
PageAI-Pro/ralph-loop

postgres

PostgreSQL best practices, query optimization, connection troubleshooting, and performance improvement. Load when working with Postgres databases.

193 28
Explore
PageAI-Pro/ralph-loop

mysql

Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations. Use when creating or modifying MySQL tables, indexes, or queries; diagnosing slow/locking behavior; planning migrations; or troubleshooting replication and connection issues. Load when using a MySQL database.

193 28
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results