Agent skill

Plan Create Prd

by coleam00 in coleam00/skills

Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem ·…

MITAuto-check passedProduct & Project Management

Install Plan Create Prd

skills CLI
$ npx skills add coleam00/skills --skill plan-create-prd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install coleam00/skills plan-create-prd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/coleam00/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/plan-create-prd .claude/skills/plan-create-prd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plan-create-prd
GitHub stars
670
Token cost
~2.1k tokens
SKILL.md length
1,074 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem ·…

  • Works in 5 steps: Initiate → Foundation (the thesis + differentiation) → Deep dive (users) → …
  • Tasks that involve PRD writing
  • SKILL.md covers The one line, Your role, Two hard guards and Process, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plan Create Prd is an agent skill from coleam00/skills. Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem · evidence · hypothesis · users · MVP · success metrics · non-goals · open questions). Use at the start of a greenfield effort to discuss the product. A PRD is INTENT (what/why), never engineering decisions (how) — those are the plan-architecture skill's spec.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering PRD writing and Essays and academic help. The repository describes itself as: The agent skills I actually use to build software with coding agents. The PIV loop, planning, worktrees, and the meta-skills for building your own AI Layer. The licence is MIT.

When your agent uses it

  • Tasks that involve PRD writing
  • Tasks that involve Essays and academic help

Example prompts

  • “/plan-create-prd”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Initiate
  2. Foundation (the thesis + differentiation)
  3. Deep dive (users)
  4. Hypothesis (the falsifiable bet)
  5. MVP & doors

What it can do on your machine

Read from SKILL.md and the folder at commit 847be08. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plan Create Prd loads about 2.1k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 1,074 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from coleam00/skills at commit 847be08, republished under its MIT licence (© coleam00). 1,074 words, ~2,098 tokens.

Download SKILL.mdSave it as .claude/skills/plan-create-prd/SKILL.md (or your agent's skills folder).
name
plan-create-prd
description
Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem · evidence · hypothesis · users · MVP · success metrics · non-goals · open questions). Use at the start of a greenfield effort to discuss the product. A PRD is INTENT (what/why), never engineering decisions (how) — those are the `plan-architecture` skill's spec.
argument-hint
[product idea] · [optional: paths to research / reference docs to ground in] (blank = start with questions)

Create PRD: Intent, Not Instructions

Input: $ARGUMENTS

Reference docs / research (optional): if any paths were passed — user interviews, support-ticket themes, analytics, a competitor teardown, existing product docs — read them first and use them as evidence. Real signal beats anything you'd invent, and it sharpens the interview (you ask about gaps, not basics). If none were passed, ask whether any exist before interviewing.

The one line

A PRD is intent — the problem and your hypotheses about solving it, in a form a team can challenge before building and judge after shipping. An AI spec is engineering decisions (the plan-architecture skill). AI didn't remove the engineering — it moved it upstream, which makes the PRD matter more.

Your role

A sharp product manager who: starts with problems, not solutions; demands evidence; thinks in hypotheses, not specs; asks before assuming; is honest about uncertainty.

Anti-fluff rule: never invent plausible requirements. Unknown → write "TBD — needs validation".

Two hard guards

  1. Intent-framed, not solution-prescriptive. Don't name the solution in the problem statement.
    • ❌ "Add a reply button to every message."
    • ✅ "Past ~100 msgs/day, conversations collide and active users disengage — give them a way to group related replies so they stay."
    • Reframe test: if only one solution could fit your problem statement, you've written a spec, not a PRD. A good problem leaves room for more than one answer.
  2. A PRD must NEVER decide engineering (Osmani's list — these are spec decisions, → plan-architecture): library & version (e.g. "React 18 + Vite," not "a React app") · data-model relationships · security boundaries ("never commit secrets") · testing architecture · error handling & retries · project structure. Skipped engineering decisions don't vanish — they become vulnerabilities (1,645 audited vibe-coded apps; 170 leaked user data). So we don't bury them — we hand them to the spec, deliberately.

Process

INITIATE → FOUNDATION → DEEP DIVE → HYPOTHESIS → MVP & DOORS → GENERATE

Ask in clusters and GATE. GATE means: post the cluster, then stop. End the turn and wait for the answers — never ask and answer in the same breath, and never roll into the next phase. Reflect thin answers back and dig.

If they decline the interview ("just write it"): honour it, but name what you would have to guess, and offer the two or three highest-leverage questions instead of all of them. Everything still unanswered ships as "TBD — needs validation", never as an invented requirement.

Phase 1 — Initiate

Input given → restate and confirm. Blank → "What do you want to build? A few sentences." GATE.

Phase 2 — Foundation (the thesis + differentiation)
  1. Who has this problem (a specific role, not "users")?
  2. What is the observable pain today?
  3. Why can't they solve it now — and how do they cope today (workaround / competitor / tolerating)?
  4. Why now — what changed?
  5. Differentiation: solving the pain is table stakes. Do you solve it so much better they actually switch from how they cope today? If not, there's no product yet.
  • GATE. The why and the switch are the heart — keep digging if vague.
Phase 3 — Deep dive (users)

Vision (one sentence) · primary user (role/context/trigger) · JTBD ("When [situation], I want to [motivation], so I can [outcome]") · non-users (who it's explicitly NOT for) · constraints. GATE.

Phase 4 — Hypothesis (the falsifiable bet)

Co-write the hypothesis. The wrong condition is the most-skipped line — and the one that makes it falsifiable:

We believe [change] will cause [these users] to [do Y], resulting in [outcome].
We'll know we're RIGHT if [leading signal] within [timeframe].
We'll know we're WRONG if [counter-signal / a guardrail moves].
  • GATE. No hypothesis ships without a wrong condition.
Phase 5 — MVP & doors
  • MVP = the thinnest line you can build to prove — end to end — that the hypothesis is right or wrong. Not "build the product." Holds → write the full spec, build it proper. Doesn't → you threw away a slice, not six months.
  • Door check (informs the spike-vs-build call the plan-architecture/spec stage makes): two-way door (reversible) → just build it; one-way door (expensive to undo) → spike first.
  • GATE before generating.
Optional lens — Cagan's four risks

If useful, pressure-test: Value (do they want it — more than the alternative?) · Usability (can they use it?) · Feasibility (can we build it?) · Viability (does it work for the business?). Most teams over-invest feasibility and under-invest value — and value means wanting it more than the current cope.

Show full SKILL.md (414 more words)Show less

Generate the PRD

Write to an idea-derived filename so a second PRD never overwrites the first: <kebab-slug>.prd.md, where the slug comes from the epic/product title or the core idea (e.g. pluggable-ingestion.prd.md). Put it in docs/ if that exists, else the repo root. (Only write to a literal path if the user passed one in $ARGUMENTS.) Never hardcode PRD.md. If the user names a tracker destination (e.g. "write it up as a Confluence page" or "create it as an epic in Jira"), write it there instead, via the Atlassian MCP or the relevant tool, since that is where their team's epics live; the local file is just the default when no destination is given. Product sections only, scannable:

  1. Problem Statement — who has what problem, and the cost of not solving it.
  2. Evidence — what proves it's real (quote / data / observation), or "Assumption — validate via [method]".
  3. Thesis (why build it) — why this, why now, and why it beats how they cope today. The heart.
  4. Hypothesis — the right/wrong "We believe …" block from Phase 4.
  5. Target User & JTBD — primary user, the job-to-be-done, non-users.
  6. MVP — the thinnest line that proves the hypothesis end to end.
  7. Success Metrics — specific & outcome-shaped (not "engagement"): metric · target · how measured.
  8. Non-goals — what you're explicitly NOT doing.
  9. Open Questions — named, not hidden (checkboxes).

Output + hand off

  • Confirm where it landed (the idea-derived filename, not PRD.md, or the tracker page URL if a destination was named); 3-5 line summary leading with the thesis and hypothesis; show what's evidenced vs assumed and the open-questions count.
  • Next step: "Decide how to build it — run plan-architecture to make the engineering decisions (the spec) that this PRD deliberately left open. That's what rules-create-global then turns into your global rules."

Success criteria — the five tests of a good PRD

  • ✅ Problem grounded in evidence — not "users want X".
  • ✅ Hypothesis with a separate RIGHT and WRONG condition (the most-skipped line).
  • ✅ Success metrics specific & outcome-shaped — not "engagement".
  • ✅ Explicit non-goals.
  • ✅ Open questions named, not hidden.
  • ✅ (guard) No engineering decisions — those went to plan-architecture.

Notes

  • Interview-led; never generate from thin air. Greenfield-first. On an existing product the epic is the input, and you decide its architecture separately with plan-architecture.
  • Solo builder? Building for yourself → you're the user; prove or kill it on yourself fast, you can jump closer to a solution. Building for someone else → you can't introspect their needs; building it right beats building it. Either way: thinnest MVP + experiments is how you learn what "right" is.

© coleam00, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/plan-create-prd of coleam00/skills.

Open the folder on GitHubat commit 847be08

Compare with similar skills

Plan Create Prd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plan Create Prd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Create Prd this skillcoleam00/skills670—~2.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Adversarial Speczscole/adversarial-spec5561 repos~8.3kAutomated safety check: NotesMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Adversarial Spec

    zscole/adversarial-spec

    Iteratively refine a product spec by debating with multiple LLMs (GPT, Gemini, Grok, etc.) until all models agree.

    556 GitHub starsUsed in 1 repo~8.3k tokens
    Product & Project ManagementAuto-check: notes
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub starsUsed in 1 repo~5.7k tokens
    Product & Project ManagementAuto-check passed

More from coleam00/skills

All 34 skills in this repo
  • Ablate AI Layer

    coleam00/skills

    Measure whether a repository's AI instructions still earn their place, by running the same real task many times with the layer intact and with it stripped, then grading every rule against what…

    670 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Build Dark Factory

    coleam00/skills

    Take a PRD and build a dark factory around it - a repository that takes work in as an issue and ships validated code out with nobody at the keyboard - one component at a time, into the user's actual…

    670 GitHub stars~12k tokensUpdated today
    Auto-check passed
  • Drive Screen

    coleam00/skills

    Take real control of the desktop - list and focus windows, type, paste, click, scroll, and screenshot - on Windows, macOS or Linux, and drive other coding-agent sessions running in terminals.

    670 GitHub stars~5.4k tokensUpdated today
    Auto-check passed
  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    670 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Build Signal Engine

    coleam00/skills

    Build a personal signal engine from scratch - a system that reads every source someone cares about each day (changelogs and release notes, communities, feeds, videos, papers), makes a quick decision…

    670 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Worktree Create

    coleam00/skills

    Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per…

    670 GitHub stars~958 tokensUpdated today
    Auto-check passed

Questions about Plan Create Prd

What does Plan Create Prd do?

Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem ·…. Plan Create Prd is an agent skill from coleam00/skills. Interactive, problem-first PRD generator — interviews the user to surface the thesis (the problem, and WHY build it) and a falsifiable hypothesis, then writes a focused PRODUCT-level PRD (problem · evidence · hypothesis · users · MVP · success metrics · non-goals · open questions).

When should I use Plan Create Prd?

Plan Create Prd fits situations like: tasks that involve PRD writing; tasks that involve Essays and academic help.

How do I install Plan Create Prd in Claude Code?

Run `npx skills add coleam00/skills --skill plan-create-prd -a claude-code`. Or copy the skill folder (.claude/skills/plan-create-prd in coleam00/skills) into .claude/skills/plan-create-prd in your project. Claude Code loads it when a task matches its description.

How do I install Plan Create Prd in Codex?

Run `npx skills add coleam00/skills --skill plan-create-prd -a codex`. Or copy the skill folder (.claude/skills/plan-create-prd in coleam00/skills) into .agents/skills/plan-create-prd in your project. Codex loads it when a task matches its description.

Can I use Plan Create Prd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coleam00/skills --skill plan-create-prd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-create-prd, .gemini/skills/plan-create-prd, .github/skills/plan-create-prd and .opencode/skills/plan-create-prd in your project.

What does Plan Create Prd need to run?

SKILL.md names no scripts, command-line tools or credentials: Plan Create Prd is instructions for the agent only.

Does Plan Create Prd access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Plan Create Prd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plan Create Prd use?

Plan Create Prd is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plan Create Prd use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plan Create Prd?

Skills that share tags, products or a category with Plan Create Prd: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Adversarial Spec (zscole/adversarial-spec, 556 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Create Prd?

coleam00 (a GitHub user) maintains it in coleam00/skills, which has 670 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 7, 2026.

Source: coleam00/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.