skills.rest
bdemarzo
bdemarzoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

idea-review

Review idea artifacts and write versioned findings-first review rounds.

2|Updated Mar 27, 2026
Search Tags:#documentation#workflow orchestration#product design#artifact validation#idea review#spec readiness
One-click install
npx skills add https://github.com/bdemarzo/ai-workflows --skill idea-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: idea-review
Source: https://github.com/bdemarzo/ai-workflows/tree/main/skills/idea-review
Command: npx skills add https://github.com/bdemarzo/ai-workflows --skill idea-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Idea-review provides a structured, evidence-aware critique of an idea artifact so teams can decide whether to advance with enough clarity, observability, and restartability for the next spec phase.

Core Features & Use Cases

  • Consolidated review round creation: Orchestrates exactly two substantive reviewers plus one skeptic and writes one official, concise consolidated round.
  • Artifact-driven workflow progression: Reviews ./docs/workflows/{slug}/idea.md and writes a new zero-padded review artifact at ./docs/workflows/{slug}/reviews/idea/round-XX.md without overwriting history.
  • Findings-first, advancement-ready output: Links the immediately prior review round (when present), summarizes deltas since then, and includes concrete suggested revisions and an explicit recommendation.

Quick Start

Ask your AI orchestrator to run the idea-review skill for the current workflow dossier using ./docs/workflows/{slug}/idea.md as the reviewed artifact.

Frequently Asked Questions about idea-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an idea artifact for spec readiness before advancing to the next workflow stage?▼

To perform idea review, ask your AI orchestrator to run the skill against your workflow dossier using the `./docs/workflows/{slug}/idea.md` artifact. The process orchestrates substantive reviewers and one skeptic to produce a consolidated, findings-first evaluation.

What is the best way to preserve evidence and history during an iterative product design review?▼

Non-destructive versioned review artifacts preserve evidence and restartability by writing new zero-padded review files at `./docs/workflows/{slug}/reviews/idea/round-XX.md`. This approach never overwrites prior history while linking immediately previous review rounds and summarizing deltas.

Does idea review provide a clear recommendation on whether to revise or advance a workflow artifact?▼

Yes, idea review provides an explicit allowed recommendation to either revise or advance the workflow artifact. The consolidated findings-first output includes concrete suggested revisions, ensuring teams have actionable decisions for downstream artifact authoring.

Can I use workflow orchestration to validate UX and workflow risks before creating product specifications?▼

Workflow orchestration validates UX and workflow risks by deploying reviewer subagents to assess product relevance and spec readiness. This structured evaluation ensures your idea artifact meets observability requirements before committing to downstream specification authoring.

What are the limitations of using automated subagents for idea review and documentation validation?▼

Automated idea review is constrained to evaluating artifact readiness and does not replace human judgment for complex product strategy decisions. It requires slug-derived round writing and existing idea documentation to function properly within the workflow orchestration framework.

Related Skills

Explore More Product & Management Skills→
bdemarzobdemarzo
2

idea-create

Convert workflow prompts into outcome-first idea.md artifacts.

Community
Intermediate
levnikolaevichlevnikolaevich
534

ln-220-story-coordinator

Decompose Epics into 5-10 User Stories with sequential numbering.

Community
Advanced
jonnathan-lsjonnathan-ls

pilulafeed

Automate end-to-end content publishing workflows with a chat-driven 10-stage pipeline.

Community
Advanced
OrestesKOrestesK
2

review

Evaluate code and plans against approved requirements with categorized findings.

Community
Advanced