idea-create

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

2|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/bdemarzo/ai-workflows --skill idea-create-bdemarzo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-create
Source: https://github.com/bdemarzo/ai-workflows/tree/main/skills/idea-create
Command: npx skills add https://github.com/bdemarzo/ai-workflows --skill idea-create-bdemarzo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It helps you convert a vague workflow prompt or product opportunity into a clear, outcome-first idea dossier that others can review without needing the original conversation.

Core Features & Use Cases

  • Outcome-first idea drafting: Captures what changes for users, why it matters, and how success would be observed in a way that’s skimmable.
  • Enhancement delta framing: For existing behavior, records current baseline, desired change, and what must be preserved so the review can judge risk.
  • Self-contained workflow artifacts: Writes or updates ./docs/workflows/{slug}/idea.md using a stable slugged format so a later reader can understand the opportunity.

Quick Start

Use the idea-create skill to draft or update ./docs/workflows/{slug}/idea.md for your workflow by providing a rough product prompt or enhancement request.

Frequently Asked Questions about idea-create

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

FAQPage Schema
How do I convert a rough product idea into a review-ready artifact?

To convert a rough product idea into a review-ready artifact, provide a raw workflow prompt or enhancement request. The skill drafts an outcome-first idea.md dossier capturing user impact, success criteria, and decision scope for stakeholder review.

How do I document an enhancement delta for an existing product workflow?

Documenting an enhancement delta records the current baseline, desired change, and behaviors that must be preserved. This framing helps reviewers judge risk by clearly separating new functionality from existing constraints within the idea artifact.

What is the best way to draft self-contained product documentation for review?

The best way to draft self-contained product documentation is writing a slugged idea.md file under ./docs/workflows/. It captures the complete opportunity context independently, ensuring reviewers understand the product strategy without needing the original conversation.

Can I update an existing idea.md without duplicating workflow dossiers?

Yes, you can update an existing idea.md without duplicating dossiers. The skill applies slug derivation to target the specific workflow file path, refining the early product opportunity definition and appending new uncertainties as risks or questions.

Does this product documentation tool require any external dependencies?

No external dependencies are required to use this product documentation tool. It operates independently using its built-in template skeleton to draft the artifact, requiring only a raw prompt or enhancement request as input to generate the review-ready file.

When should I not use an outcome-first artifact for product opportunity definition?

You should avoid using an outcome-first artifact when your product idea lacks enough definition to frame user impact or success criteria. The tool requires a baseline prompt to derive a decision-focused scope; purely exploratory ideas without a workflow context are out of scope.