prd-from-idea

prd-from-idea is a skill for Claude Code, Codex from lukedj78/dev-flow. It costs 212 tokens per session (4,123 once invoked), scanned A, original, MIT.

A planning tool that turns an unfinished product idea or brief into a project summary and a product requirements document.

In plain words
What is it for?
It creates or revises PROJECT.md and PRD.md files from written ideas or imported document content, while asking the user for important missing details.
Why use it?
It gives engineers and other contributors a shared description of the product, its users, requirements, acceptance criteria, and unanswered questions.

Skill for Claude CodeCodex

Part of the dev-flow plugin — 46 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lukedj78/dev-flow/prd-from-idea
Any agent
npx skills add lukedj78/dev-flow --skill prd-from-idea
Clone the repo
git clone --depth 1 https://github.com/lukedj78/dev-flow

Made for: Claude Code, Codex.

Or install dev-flow, the plugin that ships this one along with the rest of its 46 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for prd-from-idea

README.md
[![agentmods](https://agentmods.dev/badge/skills/lukedj78/dev-flow/prd-from-idea.svg)](https://agentmods.dev/skills/lukedj78/dev-flow/prd-from-idea)
Your own site
<a href="https://agentmods.dev/skills/lukedj78/dev-flow/prd-from-idea"><img src="https://agentmods.dev/badge/skills/lukedj78/dev-flow/prd-from-idea.svg" alt="Measured on agentmods" height="20"></a>
Per session 212 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,123 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00212 $0.04123
Opus 5 $0.00106 $0.02062
Sonnet 5 $0.00042 $0.00825
Haiku 4.5 $0.00021 $0.00412

Measured today against content hash e304c2b86093, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

prd-from-idea scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

prd-from-idea/SKILL.md · 277 lines

How it starts

The opening of the file, as written. The whole thing — 277 lines — stays where its author put it; the contents beside it link to each section on GitHub.

prd-from-idea — idea → PROJECT.md + PRD.md

This skill turns an unstructured product idea into two artifacts that downstream skills depend on:

  1. PROJECT.md — the strategic brief. One page. Audience, problem, value proposition, success criteria. The piece other humans read.
  2. PRD.md — the product requirements doc. Several pages. User stories, acceptance criteria, non-goals, open questions. The piece engineers and downstream skills consume.

The skill is interactive — it asks the user a small number of high-leverage questions and turns the answers into the docs. It does not invent PRD content from nothing.

When this skill applies

  • A user pastes a product idea ("I want to build a dashboard for X") and asks to start.
  • Orchestrator (dev-flow) routes here when phase is empty or idea_captured.
  • A PROJECT.md exists but PRD.md doesn't — the skill expands the brief into requirements.

If a PRD.md already exists, the skill enters revise mode: it reads the current PRD, asks what's wrong, and edits in place. It does not silently overwrite.

Contract

This skill follows the dev-flow contract — see references/contracts.md (vendored copy) for the canonical schema. Key facts:

  • Output goes into <project-root>/.workflow/.
  • Set phase = "idea_captured" after writing PROJECT.md; set phase = "prd_drafted" after writing PRD.md.
  • Append a history entry to meta.json for every run.

⚠️ Step 0 — the brief arrived as a file, not as a paste

The description above says "a user pastes a product idea", and often they don't: a real brief arrives as .docx, .pptx, .pdf, .xlsx — an RFP, a client deck, a spec someone wrote in Word. Do not ask the user to paste it, and do not summarise it from a partial read.

npx @firecrawl/anydoc brief.docx -o .workflow/_source/brief.md   # Word, PowerPoint, Excel,
npx @firecrawl/anydoc rfp.pdf                                    # OpenDocument, RTF, EPUB, CSV, PDF

anydoc (Firecrawl, MIT, @firecrawl/[email protected]) is a Rust binary that converts all of those to GitHub-Flavored Markdown, and it ships its own agent skillnpx skills add firecrawl/anydoc — so this file does not restate its CLI.

Read the full file on GitHub · 277 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +2 lines e304c2b86093
  2. 4d ago First seen · 275 lines · 212 tokens per session scan A 9233c72c7b09

Subscribe to this mod's changes

prd-from-idea is a skill published in the GitHub repository lukedj78/dev-flow (6 stars, last pushed today), licensed MIT. It adds 212 tokens to every session and 4,123 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

ppt-generation

Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Creates visually rich slides by generating images for each slide and composing them into a PowerPoint file.

bytedance/deer-flow · 44 tokens

data-analysis

Use this skill when the user uploads Excel (.xlsx/.xls) or CSV files and wants to perform data analysis, generate statistics, create summaries, pivot tables, SQL queries, or any form of structured data exploration. Supports multi-sheet Excel workbooks, aggregation, filtering, joins, and exporting results to…

bytedance/deer-flow · 69 tokens

scientific-schematics

Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.1 Pro Preview for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways…

xintaofei/codeg · 68 tokens

moai-workflow-docs-claim-check

Read-only check of whether the claims a public-facing document makes (README, release notes, install and usage guides) are supported by user-supplied evidence. Runs Preflight, Claim Triage, and Validation, splits composite claims into atomic ones, and labels each. Runs no commands and writes no fixes.

modu-ai/moai-adk · 72 tokens

wiki-manager

Manage LLM-compiled wikis: initialize, ingest/import, compile/query, research/audit, collect catalogs, track inventory/datasets/Ideas, review Idea/Project portfolios, manage archives/sessions/feedback, and generate outputs. Activates for /wiki commands; wiki or knowledge-base work; ingest, collect, catalog, compile…

nvk/llm-wiki · 141 tokens

moai-workflow-project

Integrated project management system covering documentation, language initialization, template optimization, docs generation, and JIT document loading. Absorbed from moai-workflow-templates, moai-docs-generation, and moai-workflow-jit-docs.

modu-ai/moai-adk · 55 tokens