PRD Task Generator

A Claude Code skill that generates bulletproof Product Requirements Documents (PRDs) with executable task lists for subagent dispatch.

What It Does

1. Explores your codebase — Understands framework, patterns, and existing files
2. Asks smart questions — With lettered options for fast answers (1A, 2C, 3B)
3. Generates PRD — Human-readable markdown document
4. Generates tasks — JSON file with self-contained prompts ready for subagents

Installation

Copy the skill to your Claude Code skills directory:

git clone https://github.com/limeygent/prd-task-generator.git ~/.claude/skills/prd

Or manually copy the files to ~/.claude/skills/prd/.

Usage

In Claude Code, run:

/prd

Or describe your feature naturally:

"I need a feature to let users bookmark articles"

Output

The skill generates two files in your project's tasks/ directory:

File	Purpose
prd-[feature].md	Human-readable PRD with user stories, requirements, and technical details
tasks-[feature].json	Machine-readable task list with self-contained prompts for each task

Task JSON Structure

Each task includes a complete, self-contained prompt:

{
  "id": "TASK-001",
  "title": "Add priority field to database",
  "prompt": "## Task: Add priority field...\n\n### Context\n...",
  "dependencies": [],
  "status": "pending"
}

The prompt field contains everything a subagent needs — no external references required.

Dispatching Tasks

Manual: Copy a task's prompt field and paste into a new Claude Code session.

Automated: Build an orchestrator that reads tasks-[feature].json and spawns agents sequentially.

File Structure

~/.claude/skills/prd/
├── skill.md                    # Main skill definition
├── references/
│   ├── prd-template.md         # PRD document structure
│   ├── task-schema.md          # JSON task format spec
│   └── examples/
│       ├── example-crud.md     # Example PRD
│       └── example-crud.json   # Example tasks
└── snarktank-archive/          # Original inspiration files

Design Principles

This skill is built to be bulletproof — no hallucinations, no confusion:

Principle	Implementation
Self-contained prompts	Each task includes ALL context needed
Codebase-aware	Explores existing code before generating
Atomic tasks	If it takes >3 sentences to describe, split it
Explicit dependencies	Tasks execute in correct order
Verifiable criteria	Every criterion is yes/no, never vague
Scope boundaries	Each task says what NOT to do

Compatibility

Environment	Supported
Claude Code CLI	Yes
VS Code + Claude Code	Yes
JetBrains + Claude Code	Yes
Claude Desktop App	No (uses MCP, not skills)
claude.ai (web)	No

Acknowledgments

This skill was inspired by Ralph by snarktank — an autonomous agent system for executing PRD-driven development tasks. The original PRD generator and converter patterns were adapted and enhanced for Claude Code's skill format.

License

MIT