idea-to-design

Transforms idea notes into design documents with research and decision records.

5|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/britt/agent-skills --skill idea-to-design-britt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: idea-to-design
Source: https://github.com/britt/agent-skills/tree/main/skills/idea-to-design
Command: npx skills add https://github.com/britt/agent-skills --skill idea-to-design-britt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Raw idea notes often stay vague and undeveloped because turning them into actionable designs requires research, technical decisions, and structured documentation. This Skill autonomously converts an idea note into a complete design package without asking the user any questions. ## Core Features & Use Cases - Autonomous Research: Investigates unknowns, explores feasibility, and records all sources and findings in Research.md. - Structured Design Output: Produces Design.md answering what the idea is, who it is for, how it works technically, and where it is deployed, with Mermaid diagrams. - Explicit Decision Tracking: Documents every assumption and choice in Decisions.md with alternatives and reasoning. - Use Case: You have a rough note in your Obsidian vault about a new app concept. Activate this Skill to get a folder containing the original note, a researched design document, a decision log, and a research summary, ready for review or handoff. ## Quick Start Turn my idea note in the Ideas folder into a full design document with research and decisions.

Frequently Asked Questions about idea-to-design

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

FAQPage Schema
How do I turn an idea note into a design document?▼

Place the idea note in an Ideas folder and activate the skill. It reads the note, researches unknowns, and generates Design.md, Decisions.md, and Research.md in a new subfolder named after the idea, without asking questions.

What files does the idea-to-design workflow produce?▼

It produces four files inside Ideas/<Idea Name>/: the original idea note moved into the folder, Design.md with the full design, Decisions.md listing choices with reasoning, and Research.md with sources and findings.

Does idea-to-design work outside Obsidian?▼

Yes, it operates on any markdown folder containing an Ideas directory, not only Obsidian vaults. If no Ideas folder is found, it asks the user for the vault path before proceeding.

When should I not use idea-to-design?▼

Do not use it for features in an existing codebase. For that scenario, use a product specification or brainstorming skill instead, since idea-to-design targets standalone raw ideas.

What diagram format does the design document use?▼

All diagrams use Mermaid syntax, which Obsidian renders natively. Architecture uses flowchart TB or LR, sequences use sequenceDiagram, and state machines use stateDiagram-v2. ASCII art is never used.