agentleFS
eren23eren23/idea-validator-plugin/skills/validate-idea/skill.md

validate-idea

Skill0 starsChanged 10 months agoMITView on GitHub

Use when starting a new business idea, product concept, or side project and need to validate assumptions, identify gaps, or stress-test the idea before building

23 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use company-values, find-community and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • insight68Skill

    company-values

    Help define company values and culture for a minimalist business. Use when someone is setting up their company culture, preparing to hire, or wanting to codify what their company stands for.

    Also in 6 projects that use this

  • insight68Skill

    find-community

    Help identify and evaluate communities to build a minimalist business around. Use when someone is looking for a business idea, trying to find their community, or wondering where to start as an entrepreneur.

    Also in 6 projects that use this

  • slavingiaSkill

    grow-sustainably

    Evaluate business decisions through the lens of sustainable, profitable growth. Use when someone is making decisions about spending, hiring, fundraising, or scaling their business.

    Also in 6 projects that use this

  • slavingiaSkill

    processize

    Turn a product idea into a manual-first process you can start delivering today. Use when you have an idea and want to figure out how to deliver value by hand before writing any code.

    Also in 6 projects that use this

  • MicrosoftSkill

    launch

    Launch and automate VS Code Insiders with the Copilot Chat extension using @playwright/cli via Chrome DevTools Protocol. Use when you need to interact with the VS Code UI, automate the chat panel, test the extension UI, or take screenshots. Triggers include 'automate VS Code', 'interact with chat', 'test the UI', 'take a screenshot', 'launch with debugging'.

    Also in 3 projects that use this

  • +4 more from insight68
  • +1 more from slavingia

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 8 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 20 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    All output saved to docs/ideas/ with version tracking.

    line 16
  2. Distinctive:

    Ask for idea name (one sentence)

    line 35
  3. Distinctive:

    Ask: "Dump everything you have about this idea - problem, solution, market, anything"

    line 36
  4. Distinctive:

    Ask: "Want to fill gaps now, or save and continue later?"

    line 39
  5. Distinctive:

    Ask questions one at a time within each section

    line 44
  6. Distinctive:

    Use multiple choice where reasonable

    line 45
  7. Distinctive:

    After each section: brief summary, confirm before moving on

    line 47
  8. Distinctive:

    Ask: Resume gaps / Review all / Start fresh

    line 53
  9. Distinctive:

    One question at a time: - Don't overwhelm

    line 221

“Common” is measured: kept by at least 6 in 10 of the 20 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
skill.md

Idea Validation

Overview

Guide users through structured validation of business ideas using a 12-section framework. Capture what's known, identify gaps, and build a complete picture before building.

Two modes:

  • Quick capture: User dumps what they know, you parse into sections
  • Interactive: Walk through gaps one question at a time

All output saved to docs/ideas/ with version tracking.

When to Use

  • Starting a new idea from scratch
  • Have a rough concept, want to pressure-test it
  • Revisiting an idea after learning more
  • Preparing to pitch (ensures thoroughness)

When NOT to Use

  • Already validated and building
  • Pure technical projects with no business model
  • Quick experiments that don't need formal validation

Workflow

Starting Fresh

  1. Ask for idea name (one sentence)
  2. Ask: "Dump everything you have about this idea - problem, solution, market, anything"
  3. Parse their input into the 12 sections below
  4. Show what was captured vs what's unknown (TBD)
  5. Ask: "Want to fill gaps now, or save and continue later?"

Filling Gaps

  • Work through one section at a time (1 -> 12)
  • Ask questions one at a time within each section
  • Use multiple choice where reasonable
  • "I don't know yet" is valid - mark as TBD
  • After each section: brief summary, confirm before moving on

Resuming Existing

  1. Load file, parse YAML frontmatter
  2. Show: "X% complete, Y gaps remaining"
  3. Ask: Resume gaps / Review all / Start fresh
  4. Resume -> jump to first incomplete section

Output Format

Save to docs/ideas/YYYY-MM-DD-idea-name.md (increment version for updates):

---
idea: "One-sentence description"
created: YYYY-MM-DD
updated: YYYY-MM-DD
version: 1
completion: 65%
gaps:
  - "Market size not researched"
  - "Pricing undefined"
---

# Idea Validation: [Name]

## 1. Problem & Value
| Question | Answer |
|----------|--------|
| Specific problem | ... |
| Who has it | ... |
| Why painful | **TBD** |
| Why now | ... |
| Clear outcome | ... |

[Sections 2-12 follow same pattern]

---
## Gaps Summary
- [ ] Section 1: Why painful?
- [ ] Section 5: Pricing

## Version History
- v1 (date): Initial capture
- v2 (date): Added market research

The 12 Sections

1. Problem & Value

QuestionGuidance
What is the specific problem?Strong: Concrete, narrow, observable. Weak: Vague, broad. Red flag: Only you have this problem.
Who has this problem?Strong: Specific persona with numbers. Weak: "Everyone" / "Small businesses". Follow-up: Can you name 3 people?
Why is it painful or costly?Quantify if possible. Time lost, money lost, frustration level.
Why does this problem matter now?Strong: Market shift, new tech, regulation. Weak: "Always been a problem". Red flag: No urgency.
What is the clear outcome?What does success look like for the user? Be specific.

2. Solution

QuestionGuidance
What exactly are you offering?Describe the product/service concretely.
How does it solve the problem?Direct cause -> effect. Not features, but outcomes.
What is the one core benefit?Force prioritization. If you had to pick ONE thing.
How is it different from existing solutions?Be honest. "Faster" isn't enough - how much faster?
What does it NOT try to solve?Scope clarity. What's explicitly out of bounds?

3. Market

QuestionGuidance
How big is the problem?Number of people affected, frequency, severity.
Market size (TAM/SAM/SOM)?Even rough estimates help. Red flag: "Trillion dollar market" with no breakdown.
Who is the initial target user?Narrow is good. First 100 customers, not first million.
Who is explicitly NOT the target?Helps focus. "Not enterprise", "Not consumers".
Buyer ≠ user?If yes, who pays? This changes everything about sales.

4. Competition

QuestionGuidance
Direct competitors?Who solves the same problem the same way?
Indirect/substitute solutions?What else do people use? Including "do nothing".
How do people solve this today?Current behavior, even if inefficient.
Why would they switch?Switching has costs. What overcomes inertia?
What is your unfair advantage?Be honest. "None yet" is valid. Network effects, proprietary data, expertise?

5. Business Model

QuestionGuidance
How do you make money?Subscription, one-time, ads, transaction fee?
Pricing logic makes sense?Based on value delivered, competitor pricing, or cost-plus?
Will people realistically pay?Have you asked? Red flag: "They should want to pay".
Main cost drivers?What scales with users? What's fixed?
Can this scale?Unit economics at 10x, 100x current size?

6. Communication & Usability

QuestionGuidance
Can a 15-year-old understand it?Test: Explain in one sentence without jargon.
Can a 65-year-old understand it?Not about age - about assumptions and context.
No jargon required?Industry terms = barrier to entry.
Time to first value is short?How long until user gets benefit? Minutes, hours, days?
Anyone can start without help?Self-serve or requires onboarding?

7. Industry & Positioning

QuestionGuidance
What industry are you in?Simple category. Fintech, healthtech, productivity, etc.
One-sentence company description?"We help [who] do [what] by [how]".
What category do you want to own?Be specific. "Project management" is crowded. "Project management for construction crews" is ownable.
What should people associate with your brand?Pick 2-3 words. Fast? Reliable? Friendly? Premium?

8. Brand & Purpose

QuestionGuidance
Why does this exist?Beyond making money. What drives you?
What belief or principle drives it?Core conviction about how things should be.
Why should anyone care?From their perspective, not yours.
Is the story easy to remember?Can someone retell it accurately?

9. Defensibility & Risk

QuestionGuidance
Is it patentable?Usually no, and that's fine. But know the answer.
If not, what protects you?Brand, network effects, switching costs, speed, relationships?
What is easy to copy?Be honest. Features are easy. Distribution is hard.
What gets stronger over time?Data moats, community, brand recognition?
Biggest risks identified?Technical, market, team, regulatory? Name them.

10. Execution & Roadmap

QuestionGuidance
Smallest useful version (MVP)?What's the minimum to test the core hypothesis?
What will be built first?Prioritization clarity.
What is intentionally delayed?Shows discipline. Red flag: Everything is v1.
Basic measurement in place?How will you know it's working?
Clear next milestone?Specific, time-bound, measurable.

11. Reality Check

QuestionGuidance
What must be true for this to work?List assumptions. Then validate them.
What would make you stop?Kill criteria. Know when to quit.
What assumption is most dangerous?If wrong, everything falls apart. Test this first.
Why you / this team?Honest assessment of fit.
Why now?Timing matters. What changed recently?

12. Pitch Readiness

QuestionGuidance
Problem in one sentence?Elevator test.
Solution in one sentence?No jargon.
Why you win?Differentiation + credibility.
Why now?Urgency and timing.
Clear vision for the future?Where does this go in 5 years?

Key Principles

  • One question at a time - Don't overwhelm
  • TBD is valid - Unknown gaps are valuable to surface
  • Quantify when possible - Numbers beat adjectives
  • Be honest - Weak answers now prevent failed launches later
  • Iterate - Ideas evolve, revisit and update

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.