ferdinandobons/startup-skill / startup-design
startup-design
VerifiedDesign, validate, and plan a startup from scratch. Covers market research, competitive analysis, business model, brand identity, product definition, financial projections, and validation experiments. Trigger when the user has a startup idea to explore, wants to validate a business concept, needs a business plan or lean canvas, asks for market sizing or competitive landscape, wants brand positioning or go-to-market strategy, or says anything like "I have an idea for..." or "is this idea worth pursuing". Also handles resuming from a previous checkpoint.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 31.8 KB |
| references/customer-interview.md | markdown | 8.6 KB |
| references/frameworks.md | markdown | 6.1 KB |
| references/honesty-protocol.md | markdown | 5.0 KB |
| references/industry-benchmarks.md | markdown | 2.8 KB |
| references/intake-questions.md | markdown | 2.6 KB |
| references/output-guidelines.md | markdown | 6.5 KB |
| references/output-specs.md | markdown | 5.7 KB |
| references/research-principles.md | markdown | 2.7 KB |
| references/research-scaling.md | markdown | 4.8 KB |
| references/research-synthesis.md | markdown | 6.4 KB |
| references/research-wave-1-market.md | markdown | 6.7 KB |
| references/research-wave-2-competitors.md | markdown | 7.5 KB |
| references/research-wave-3-customers.md | markdown | 8.3 KB |
| references/research-wave-4-distribution.md | markdown | 4.1 KB |
| references/verification-agent.md | markdown | 5.1 KB |
references/verification-agent.md
View on GitHub# Verification Agent Protocol
After synthesis completes, spawn a **Verification Agent (V1)** that audits all deliverables for consistency, accuracy, and completeness. This step catches issues that individual agents and synthesis can miss.
## When to Run
- After synthesis is complete and all deliverable files are written
- Before the next phase begins (e.g., before Phase 3.5 Research Gate in startup-design)
- Uses one agent: **V1: Verification**
## Agent Task
The V1 agent reads ALL deliverable files (not raw files) and checks them against the rules below. It produces a `verification-report.md` in the project directory.
## Universal Checks
These apply to every skill in the startup plugin:
### 1. Claims Without Source
Every quantitative claim must have a data label: **[Data]**, **[Estimate]**, **[Assumption]**, or **[Opinion]**. Flag any number, percentage, or factual assertion without a label.
### 2. Internal Contradictions
Cross-check numbers and statements across deliverable files. Flag when:
- The same metric appears with different values in two files
- A claim in one file contradicts a claim in another
- Confidence ratings disagree (e.g., "High confidence" in one file, different data in another suggests Medium)
### 3. Confidence Rating Consistency
Verify that confidence ratings match the evidence:
- A claim with only one Tier 3 source cannot be rated **High**
- A claim with multiple Tier 1 sources should not be rated **Low**
- Every major section must have a confidence rating
### 4. Data Gaps Declared
Every deliverable must have a Data Gaps section. Flag:
- Files missing the Data Gaps section entirely
- Sections where data is clearly thin but no gap is declared
- Gaps mentioned in raw files that didn't make it into the synthesized deliverables
### 5. Flags Present
Every deliverable must end with Red Flags and Yellow Flags sections. Flag:
- Files missing these sections
- Files with "No flags identified" where the content clearly contains risks
### 6. Stale Data
Flag any data point older than 18 months that isn't marked as potentially outdated.
### 7. Duplicate Sources
Flag when the same source is used as "independent corroboration" in multiple places. Two claims both citing the same blog post don't have independent verification.
## Skill-Specific Checks: startup-design
In addition to the universal checks above, verify:
### Cross-Phase Consistency
- **Strategy reflects market data:** Do the Lean Canvas, positioning, and GTM in Phase 4 reference specific findings from Phase 3? Flag strategy claims that have no research backing.
- **Product reflects customer pains:** Does the MVP definition (Phase 6) address the top pains identified in `target-audience.md`? Flag features that don't map to any validated customer need.
- **Financial reflects business model:** Do the revenue projections (Phase 7) use the pricing and unit economics from `market-analysis.md` and `business-model.md`? Flag projection assumptions that contradict research data.
- **Validation covers key risks:** Does the risk analysis (Phase 8) address the Red Flags and data gaps surfaced in earlier phases? Flag risks that were identified in research but missing from validation.
### Numerical Consistency
- TAM/SAM/SOM numbers must be consistent across `market-analysis.md`, `lean-canvas.md`, and `revenue-model.md`
- Pricing references must match between `competitor-landscape.md` and `business-model.md`
- Customer segment descriptions must be consistent between `target-audience.md`, `lean-canvas.md`, and `mvp-definition.md`
## Output: verification-report.md
```markdown
# Verification Report: {project-name}
*Generated: {date}*
## Summary
- **Critical issues:** {count}
- **Warnings:** {count}
- **Info:** {count}
## Critical Issues
Issues that could mislead decision-making. The process pauses here for user review.
### {Issue title}
- **File(s):** {affected files}
- **Section:** {section name}
- **Problem:** {description}
- **Suggested fix:** {how to resolve}
## Warnings
Issues that reduce quality but don't block decisions.
### {Issue title}
- **File(s):** {affected files}
- **Problem:** {description}
- **Suggested fix:** {how to resolve}
## Info
Minor improvements and observations.
- {observation}
- {observation}
## Verification Checklist
- [ ] All quantitative claims labeled
- [ ] No internal contradictions found
- [ ] Confidence ratings consistent with evidence
- [ ] Data gaps declared in all deliverables
- [ ] Red/Yellow flags present in all deliverables
- [ ] No stale data unmarked
- [ ] No duplicate-source false corroboration
- [ ] Strategy reflects market data (cross-phase)
- [ ] Product reflects customer pains (cross-phase)
- [ ] Financial reflects business model (cross-phase)
- [ ] Validation covers identified risks (cross-phase)
```
## Flow Control
- **If Critical issues > 0:** Pause. Show the user: "Verification found {N} critical issues that could affect decision-making." List them. Ask: "Should I fix these before continuing, or proceed as-is?"
- **If only Warnings/Info:** Show a one-line summary: "Verification complete: {N} warnings, {N} info items. See `verification-report.md` for details." Continue to next phase.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |