skills/idea-validator/SKILL.md
Orchestrates business idea validation via parallel sub-agents: Lean Canvas, JTBD, market/competitive/feasibility research, SWOT/PESTLE, and a weighted scorecard with verdict. Triggers on: "validate this idea", "evaluate my startup idea", "is this idea worth pursuing", "score this business idea", "validate my pitch".
npx skillsauth add mathews-tom/armory idea-validatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Perform rigorous, multi-dimensional validation of business ideas by orchestrating parallel research and synthesizing findings into a scored, actionable report. The goal is honest assessment — surfacing what holds up under scrutiny and what does not — rather than cheerleading or reflexive dismissal.
Classify the input:
| Input Type | Indicators | Adaptation | | ---------------- | ------------------------------------------- | ------------------------------------------- | | Elevator pitch | 1-3 sentences, informal | Extract hypothesis, ask for missing details | | Business plan | Structured, multiple sections | Validate claims against research | | Feature proposal | Technical focus, existing product context | Narrow scope to feature viability | | Repo/codebase | File paths, code references | Technical feasibility + market fit | | Pivot assessment | "Should we pivot to...", comparison context | Compare current vs proposed direction |
Extract core elements from the input:
If any core element is missing or ambiguous, ask clarifying questions. Cap at 5 questions. Do not proceed with fabricated assumptions for missing elements — get real answers.
Build a complete Lean Canvas using references/lean-canvas.md as the framework guide.
Populate all 9 boxes:
For each box:
Apply the JTBD framework from references/jtbd-framework.md:
Assess whether the proposed solution addresses the core job better than current alternatives. Identify the four forces of progress: push of current situation, pull of new solution, anxiety of change, habit of status quo.
Use the Agent tool to spawn three research agents in parallel. Each agent receives a focused research brief derived from the idea context established in Phases 1-3. These agents perform the same analysis covered by the complementary skills (market-analyzer, competitive-analyzer, feasibility-assessor) — when those skills are installed, their reference frameworks inform the analysis depth; when running standalone, the agents use the inline briefs below.
Prompt the agent:
Analyze the market opportunity for [idea summary with target customer and problem context]. Research TAM/SAM/SOM estimates, market growth trends, customer segment sizing, and timing signals. Use WebSearch to find industry reports, market data, analyst projections, and trend indicators. Produce a structured market analysis with quantified estimates and cited sources. Include: market size estimates with methodology, growth rate and trajectory, key market drivers, timing assessment (too early, right time, too late), and customer willingness to pay signals.
Prompt the agent:
Analyze the competitive landscape for [idea summary with solution and value proposition context]. Discover direct competitors (same solution, same customer), indirect competitors (different solution, same job-to-be-done), and potential competitors (adjacent players who could enter). Compare features, pricing, and positioning across competitors. Assess Porter's Five Forces for this industry. Identify moats and defensibility factors. Use WebSearch for competitor data from Product Hunt, G2, Capterra, Crunchbase, and company sites. Produce a structured competitive analysis with competitor matrix, force scores, and positioning assessment.
Prompt the agent:
Assess the financial and technical feasibility of [idea summary with solution details and revenue model]. Calculate unit economics using industry benchmarks: customer acquisition cost (CAC), lifetime value (LTV), LTV:CAC ratio, gross margins, payback period. Evaluate technical complexity: architecture requirements, key technical risks, build vs buy decisions, infrastructure needs. Estimate build timeline and team composition for MVP and v1. Use WebSearch for comparable company benchmarks, SaaS metrics benchmarks, and technical stack assessments. Produce a structured feasibility report with financial projections, technical risk matrix, and resource requirements.
Wait for all three agents to return results before proceeding.
Using the combined outputs from Phases 2-4, construct both analyses per references/swot-pestle.md.
Derive strategy implications: SO strategies (use strengths to capture opportunities), WO strategies (address weaknesses to unlock opportunities), ST strategies (use strengths to counter threats), WT strategies (minimize weaknesses and avoid threats).
Assess macro-environment factors:
Prioritize factors by impact and likelihood. Feed high-impact factors into SWOT external quadrants.
Score across 6 dimensions using references/validation-scoring.md:
| Dimension | Weight | Score Range | Primary Sources | | --------------------- | ------ | ----------- | -------------------------- | | Problem-Solution Fit | 25% | 1-5 | Lean Canvas, JTBD | | Market Opportunity | 20% | 1-5 | Market Research Agent | | Competitive Position | 15% | 1-5 | Competitive Analysis Agent | | Financial Viability | 20% | 1-5 | Feasibility Agent | | Technical Feasibility | 10% | 1-5 | Feasibility Agent | | Timing & Environment | 10% | 1-5 | PESTLE, Market Research |
Compute weighted overall score. Map to verdict:
Identify any red flags that override scores (legal impossibility, ethical concerns, physical impossibility). A single critical red flag can downgrade the verdict regardless of score.
Assess confidence level: how certain are the inputs driving each score? Flag dimensions where data is thin or speculative.
Produce the final validation report in this structure:
# Business Idea Validation Report
## Meta
| Field | Value |
| ------------- | --------------------------------------------------------- |
| Date | YYYY-MM-DD |
| Input Type | [elevator pitch / business plan / feature / repo / pivot] |
| Overall Score | X.X / 5.0 |
| Verdict | [Strong / Promising / Risky / Weak] |
## Executive Summary
[3-5 sentences: what the idea is, the key finding, the main risk, the recommendation]
## Lean Canvas
[Completed canvas with assessment notes per box]
## Problem-Solution Fit
[JTBD analysis, switching triggers, current alternatives, fit assessment]
## Market Opportunity
[TAM/SAM/SOM, growth trends, timing assessment — from market research agent]
## Competitive Landscape
[Competitor matrix, Porter's Five Forces, positioning — from competitive agent]
## Financial & Technical Feasibility
[Unit economics, build estimate, risk scores — from feasibility agent]
## SWOT Analysis
[4-quadrant analysis with strategy implications]
## PESTLE Scan
[Macro environment factors prioritized by impact]
## Validation Scorecard
[6 dimensions with scores, weights, justification, confidence levels]
## Red Flags
[Ranked list of critical concerns that could invalidate the idea]
## Recommended Validation Experiments
[Ordered by: cheapest test of riskiest assumption]
1. [Experiment] — tests [assumption] — cost: [effort/money] — timeline: [days]
2. ...
## What Survives Scrutiny
[Honest assessment of what holds up after thorough analysis]
testing
Manages dependent branch stacks and stacked pull requests using safe Git topology rules. Triggers on: "create stacked PRs", "publish this stack", "sync my PR stack", "rebase this stack", "merge the stack", "retarget child PRs", "split this branch into stacked PRs", "validate this stack", "cleanup stacked branches". Use when local branches or one source branch need to become a dependency-ordered PR stack with correct parent bases, validation, synchronization, merge order, and cleanup.
development
Scaffolds per-repository agent context so coding agents share the same issue tracker rules, triage label vocabulary, domain glossary, ADR layout, and handoff conventions. Triggers on: "set up project context", "configure agent docs", "create CONTEXT.md", "setup agent workflow", "agent issue tracker setup", "triage labels", "domain glossary for agents". Use when a repo needs durable context files before planning, triage, debugging, TDD, architecture review, or multi-agent implementation.
testing
Produces phased task boards from feature requests: dependency-mapped work items, parallelization flags, risk flags, edge cases, test matrices. Triggers on: "decompose this feature", "task breakdown with dependencies", "phased implementation plan", "work breakdown structure". NOT for effort estimates, use estimate-calibrator.
development
Hypothesis-driven debugging with ranked hypotheses, git bisect strategy, instrumentation planning, and minimal reproduction design. Triggers on: "debug this systematically", "root cause analysis", "bisect this bug", "rank hypotheses", "isolate this issue", "minimal reproduction". NOT for general reasoning.