idea-md

Create or expand Idea.md concept briefs from rough notes, repos, and conversation context.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill idea-md-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-md
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/idea-md
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill idea-md-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Early-stage product ideas often live as scattered notes, chat fragments, or half-written drafts that are hard to validate or hand off. This Skill turns that raw material into a structured, repo-grounded Idea.md concept brief that bridges brainstorming and formal PRD work. ## Core Features & Use Cases - Three operating modes: create a new idea file, expand a rough draft, or rewrite an existing Idea.md for clarity and structure. - Repo-aware grounding: inspects README, specs, and existing docs so the brief reflects real technical context instead of invented assumptions. - Default template and research references: ships a house template and a researched definition of Idea.md patterns when no local convention exists. - Use Case: After a brainstorming chat about a new portfolio-alert feature, ask the assistant to capture it as an Idea.md; it synthesizes the conversation, checks the repo for integration points, and produces a concise brief with problem, user, MVP, risks, and validation steps. ## Quick Start Ask the assistant to turn your rough product idea or existing notes into a structured Idea.md file for this repository.

Frequently Asked Questions about idea-md

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

FAQPage Schema
How do I turn a rough product idea into an Idea.md file?

Provide your rough description, notes, or conversation context and ask for an Idea.md. The skill synthesizes the material into a structured brief covering problem, target user, proposed solution, MVP, risks, and validation steps.

What is the difference between an Idea.md and a PRD?

An Idea.md is a concise concept brief that frames the problem, user, and solution for validation. A PRD goes further with requirements, scope, acceptance criteria, and delivery details, so Idea.md deliberately stops before that level of specificity.

Can I expand or rewrite an existing Idea.md draft?

Yes, the skill supports expansion and rewrite modes in addition to creating new files. It preserves the original meaning and distinctive phrasing while improving structure, removing repetition, and surfacing implicit assumptions.

Does the Idea.md skill use my repository context?

Yes, when a repo is available it inspects the README, specs, and related docs before writing. The brief then references concrete systems, constraints, and integration points rather than inventing technical context.

What sections should an Idea.md contain?

The default structure includes title, overview, problem, target user, proposed solution, differentiators, repo or technical fit, MVP, risks and open questions, and validation next steps. If the repo has its own convention, that format takes precedence.