idea-review
Skill2 starsChanged 2 months agoMITView on GitHub
Turn a raw product idea into an honest verdict and a build plan. Use when someone pitches an idea, says "I want to build X", or asks whether an idea is worth doing. Researches the market first, scores the idea across seven dimensions, then writes a task list a coding agent can execute.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- clarknova99/multi-provider-harnesstheir own version, first seen Jul 12, 2026
- seven0813/Idea-Copilottheir own version, first seen Jul 11, 2026
- napnap11/claude-skillstheir own version, first seen Jun 26, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- seven0813/Idea-Copilot★ 3same name
- clarknova99/multi-provider-harness★ 1same name
- napnap11/claude-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 9 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Every report must include a "How this most likely dies" section with concrete failure paths, not vague hand-waving about "a competitive …
- Distinctive: line 15
If research turns up a mature free or open-source alternative, say so in the opening paragraph, not buried in section three.
- Distinctive: line 23
Ask at most one round of 2–3 questions.
- Distinctive: line 40
If you can't fill in any one of these lines, the idea isn't formed yet.
- Distinctive: line 52
Use WebFetch to read the key pages, not just search snippets.
- Distinctive: line 79
Only when the verdict isn't "don't build it".
- Distinctive: line 108
Keep tasks between half a day and two days.
- Distinctive: line 118
Write them to the session's output directory and deliver them as files.
- Distinctive: line 120
Keep the chat reply to two or three sentences: the verdict, plus the single most important risk.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Idea Review
Turn a vague idea into two things: an honest verdict (should this be built, and why) and an executable task list (if yes, how).
Rule zero: do not be a cheerleader
People arrive attached to their own ideas and expecting validation. The default response drifts toward flattery — and flattery makes this skill worthless.
- Every report must include a "How this most likely dies" section with concrete failure paths, not vague hand-waving about "a competitive market".
- If research turns up a mature free or open-source alternative, say so in the opening paragraph, not buried in section three.
- "Don't build this" and "build this much smaller thing instead" are valid verdicts. Deliver them without apologising and without cushioning.
- Separate facts (with sources) from judgement (yours). Market numbers need a link; if you can't find one, write "no reliable public data" — never invent a figure.
Process
1. Clarify (when someone is there to answer)
Ask at most one round of 2–3 questions. Only ask what would change the verdict:
- Who is this for — yourself, a niche community, or a commercial product? This sets the entire evaluation baseline.
- How much investment is expected — a weekend, a few months, full-time?
- Any hard constraints — required stack, self-hosting, budget ceiling, deadline?
Skip this when the user already covered it, or when running unattended (a scheduled run, or the user said "just go"). In that case state your assumptions at the top of the report.
2. Restate the idea
Break it into four lines so the user can immediately see whether you understood it:
- Who, in what situation, hits what problem
- How they cope today
- Why this idea is better
- Delivery form (web / app / CLI / plugin / API / hardware)
If you can't fill in any one of these lines, the idea isn't formed yet. Say that instead of forcing out a report.
3. Research (do not skip)
Research before judging. Fire parallel searches in one batch rather than serially. Cover at least:
- Direct competitors: name, pricing, user base or reviews. Search in English and in the user's local-market language — the answers often differ.
- Open-source alternatives: what already exists on GitHub (stars, last commit, activity).
- State of the enabling tech: is the hard part already a mature library or API, and what does it cost? For metered APIs, work out the per-unit cost.
- Demand-side signal: is anyone on Reddit, Hacker News, or the relevant local forums complaining about this problem?
- Regulatory tripwires: mandatory when payments, health, education, scraping, user-generated content, or personal data are involved.
Use WebFetch to read the key pages, not just search snippets.
Research with a falsifying mindset: actively search "why did X fail", "X alternative" — not only material that supports the conclusion you already like.
4. Scorecard
Seven dimensions, 1–5 each, with one line of reasoning and its basis (source, or explicitly marked as judgement):
| Dimension | What you're looking at |
| Pain intensity | "Can't stand it" vs "nice to have". Has anyone paid to solve it? |
| Market size | Reachable user count. Niche is fine, but name the ceiling. |
| Differentiation & moat | Could an incumbent clone it in a week? Is the moat data, distribution, UX, or cost? |
| Technical feasibility | What's the most uncertain part, and is there a proven fallback? |
| Cost & effort | Person-months, plus recurring cost (hosting, APIs, moderation). |
| Path to revenue | Who pays, how much, when. Free tools still need a reason the effort is worth it. |
| Risk | Compliance, platform dependency (API cutoff, store removal), legal, single points of failure. |
Then one sentence of verdict, exactly one of:
- Build it — proceed to the technical plan
- Build it if — one fatal assumption must be validated first; give the validation method and the bar (how long, how much, what result counts as a pass)
- Build something smaller — the idea is too big; name the smaller thing to do first
- Don't build it — give the reason, and one adjacent direction worth more
5. Technical plan
Only when the verdict isn't "don't build it". Include:
- Architecture sketch: a Mermaid diagram of components or data flow — not just prose
- Stack choices: for each key decision, one recommendation, one alternative, and the reason. Favour the stack the user already knows.
- Data model: core entities and relationships. Enough to be useful; not full DDL.
- Hard parts: at most three, each with a mitigation and a downgrade path if the mitigation fails
- MVP boundary: explicitly list what v1 does not do. This matters more than the feature list.
- Milestones: 3–4 stages, each with a verifiable output and a rough duration
6. Development task list
A separate file, written for a coding agent rather than a human reader. Each task:
### T-03 User authentication
**Goal**: email signup/login with persistent sessions
**Acceptance criteria**:
- [ ] Visiting /dashboard while logged out redirects to /login
- [ ] Signup logs the user in; the session survives a page refresh
- [ ] A wrong password returns 401 without revealing whether the account exists
**Depends on**: T-01 (scaffold), T-02 (database schema)
**Touches**: src/auth/, middleware/session.ts
**Estimate**: 0.5 dayRequirements:
- Order by dependency; mark which tasks can run in parallel
- Acceptance criteria must be machine-checkable or click-checkable behaviour, never "delivers a good user experience"
- Keep tasks between half a day and two days; split anything larger
- The first task is always the smallest skeleton that runs — an end-to-end hello world
Output
Two Markdown files, named after a short slug for the idea:
<slug>-feasibility.md<slug>-tasks.md(skip when the verdict is "don't build it")
Write them to the session's output directory and deliver them as files. If the user has a local folder connected, write them there too.
Keep the chat reply to two or three sentences: the verdict, plus the single most important risk. Don't restate the report — the user will open it.
Common failure modes
- Skipping research and writing from memory — the most common and the most damaging. Market and competitor claims must come from this session's searches.
- Writing a requirements doc instead of an evaluation — the point of the report is the should we judgement, not a feature inventory.
- Mismatching the reader's level — don't explain REST to a senior engineer; don't open with Kubernetes for a beginner.
- An MVP that isn't small — if the v1 list exceeds 15 tasks, cut again.
- Every idea scores a 4 — a scorecard with no spread is noise. Give a 2 when a 2 is right.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

