Skip to main content
skill CX Codex

diagnose · getagentseal — Claude Code skill: startup diagnostic router

A router skill that helps a founder work out what is actually broken and pick one framework instead of guessing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add getagentseal/founder-playbook --skill diagnose -a claude-code
Open on GitHub

What diagnose does

Reach for this one first, when the problem is vague. The skill walks through questions in order: are people paying, do they understand the product, are the right people finding you, are they buying, is the sales process moving. Each answer points to one of five root causes — product, market, messaging, distribution, pricing.

The output is deliberately narrow: one primary skill, one optional secondary, and one concrete action for the week. Stacking three or four frameworks is ruled out. If two genuinely apply, they get sequenced rather than run side by side. The suggested action is meant to be something a solo founder can actually finish.

It also tells you when no framework fits and the honest next step is talking to people. Install it before the other skills in the set, since it decides which of them you need.

What it helps with

  • find the real root cause behind a vague startup problem
  • tell a product problem apart from a marketing problem
  • pick one framework instead of trying all of them
  • get a single concrete action for the week
  • avoid pivoting early because the message is unclear

Example prompts for the agent

  • nothing is working, where do I even begin
  • why aren't people buying my product
  • what should I focus on right now

How to install diagnose

1Skills CLI (Vercel)

npx skills add getagentseal/founder-playbook --skill diagnose -a claude-code

2Manually: put the files in place

~/.claude/skills/diagnose/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/diagnose/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about diagnose

How do I install diagnose in Claude?

Run npx skills add getagentseal/founder-playbook --skill diagnose -a claude-code. The skill lands at ~/.claude/skills/diagnose/SKILL.md.

What does diagnose do?

It is a diagnostic router for founders. It identifies the root cause and points you to one matching skill from the set.

When should I use it?

First, before any specific skill. If you already know what is broken and which framework you need, you can skip it.

Source text

SKILL.md · MIT
---
name: diagnose
description: "Startup diagnostic router. Use FIRST when a founder doesn't know where to start, has multiple overlapping problems, or asks a vague question like 'what's wrong with my startup', 'why aren't people buying', 'what should I focus on', 'where do I even begin', 'nothing is working'. Routes to the right framework from the 15 available skills — or tells you when no framework fits and you just need to go talk to people. This is the entry point. Use it before reaching for any specific skill."
---

> **Note:** This skill is independent analysis and commentary, not a reproduction of any original text. It synthesizes frameworks from multiple books with modern startup practice and routes founders to the right tool for their situation.

# Diagnose

> "The dangerous moment is when you apply the right framework to the wrong problem."

## When to Use This Skill

```
Do you know exactly what's broken?
|-- YES --> Do you know which framework to use?
|   |-- YES --> Go use that skill directly. You don't need this.
|   +-- NO  --> THIS SKILL. You know the problem, need the tool.
+-- NO  --> THIS SKILL. Start here.
```

This skill exists because frameworks are tools, not answers. A hammer doesn't help when the problem is a screw. The first job is diagnosis — figuring out what's actually broken before reaching for any specific framework.

---

## The Five Failure Modes

Every startup problem maps to one of five root causes. Most founders misdiagnose which one they have.

| Failure Mode | What It Looks Like | Common Misdiagnosis |
|---|---|---|
| **Product** | People try it and stop using it | "We need better marketing" |
| **Market** | Can't find anyone who cares enough to pay | "We need to build more features" |
| **Messaging** | Good product, people don't understand what it does | "The product must be wrong" |
| **Distribution** | People would buy it but never hear about it | "We need a better website" |
| **Pricing** | People want it but won't pay what you charge | "We need more features to justify the price" |

### The Misdiagnosis Problem

Founders almost always misdiagnose their problem by one layer. The pattern:

```
ACTUAL PROBLEM:        WHAT FOUNDERS THINK:        WHAT THEY DO:
Product problem    →   "Marketing isn't working"   →   Spend on ads (waste)
Market problem     →   "Need more features"        →   Build for months (waste)
Messaging problem  →   "Product must be wrong"     →   Pivot prematurely (waste)
Distribution       →   "Need better website"       →   Redesign 5 times (waste)
Pricing problem    →   "Need more value"            →   Add features nobody asked for (waste)
```

---

## The Diagnostic

Answer these honestly. Not what you hope is true — what the evidence says.

### Step 1: Do people want this?

```
Have at least 5 people given you real money (or signed a binding LOI)?
|-- YES --> Go to Step 2.
|-- NO  --> Have you talked to 10+ potential customers about their problem
|           (not your solution)?
|   |-- YES --> Did they describe the problem with emotion and specifics?
|   |   |-- YES --> You probably have a messaging, pricing, or distribution
|   |   |           problem. Go to Step 2.
|   |   +-- NO  --> You might have a MARKET problem. The problem you're
|   |               solving may not be painful enough to pay for.
|   |               → Use mom-test to validate the problem exists.
|   |               → Use four-steps Customer Discovery process.
|   +-- NO  --> STOP. You are guessing. Nothing else matters until you
|               talk to real people. → Use mom-test.
```

### Step 2: Can people understand what you do?

```
Show your website/pitch to a stranger for 5 seconds. Can they tell you:
  1. What you offer?
  2. How it makes their life better?
  3. What they should do next?

All 3 clear?
|-- YES --> Go to Step 3.
|-- NO  --> You have a MESSAGING problem.
|           → Use storybrand to restructure your message.
|           → Use made-to-stick to make individual messages land.
|           → Use obviously-awesome if the confusion is about
|             what category you belong in.
```

### Step 3: Are the right people finding you?

```
Are potential customers discovering your product?
|-- YES, enough volume → Go to Step 4.
|-- YES, but wrong people → You have a POSITIONING problem.
|   → Use obviously-awesome to redefine your target segment.
|   → Use crossing-the-chasm if you're reaching innovators
|     but need pragmatists.
|-- NO → You have a DISTRIBUTION problem.
|   → Use traction to systematically test channels.
|   → Use 100m-leads for tactical execution in chosen channels.
|   → Use money-models if you can't AFFORD the channels that work (make acquisition self-funding first).
```

### Step 4: Are they buying?

```
People find you, understand you, but don't buy. Why?
|-- "Too expensive" → PRICING problem.
|   → Use monetizing-innovation to redesign price+product together.
|   → Use 100m-offers to repackage the offer.
|-- "Not sure it'll work for me" → TRUST problem.
|   → Use influence (social proof, authority).
|   → Use storybrand (guide authority + testimonials).
|-- "I'll think about it" (then ghost) → URGENCY problem.
|   → Use 100m-offers (scarcity, urgency, bonuses, guarantees).
|   → Use influence (scarcity, commitment/consistency).
|-- "Went with competitor" → POSITIONING problem.
|   → Use obviously-awesome to find your unique value.
|   → Use blue-ocean-strategy if the market is commoditized.
|-- Signing up but churning → PRODUCT problem.
|   → Use lean-startup to measure and iterate.
|   → Use mom-test to understand why they leave.
|-- Buying once but never again / LTV too low to fund growth → MONEY MODEL problem.
|   → Use money-models (upsells, downsells, continuity).
```

### Step 5: Is the sales process working?

```
For B2B / high-touch sales:
|-- Meetings happen but deals stall → SALES PROCESS problem.
|   → Use spin-selling for the conversation structure.
|   → Use influence for persuasion mechanics.
|-- Can't get meetings → Back to Step 3 (distribution).
|-- Deals close but take too long → Use spin-selling
|   (you're probably skipping Implication questions).
```

---

## The One-Skill Rule

**Every diagnosis should output: one primary skill, one secondary skill (optional), and one concrete next action the founder can do this week.**

Do not stack 3-4 frameworks. Framework stacking creates the illusion of thoroughness while reducing usability. A founder drowning in problems doesn't need four life preservers thrown at once — they need one rope and clear instructions.

If two skills genuinely both apply, sequence them: "Do X first (skill A). Only after you have results, then apply skill B." Never in parallel.

The concrete next action must be something a solo founder can actually do — not "100 outreach attempts per day" but "send 10 DMs to people who posted about this problem on Reddit this week." Precision that sounds good but can't be executed is fake precision.

---

## When No Framework Fits

Sometimes the answer is: **none of these frameworks apply to your situation right now.**

Signs you should stop using frameworks and just go observe reality:

- You've been through 3+ frameworks and nothing improved. The problem might not be strategic — it might be execution, team, timing, or market conditions no book anticipated.
- Your situation is genuinely novel. Frameworks are built from patterns of past companies. If you're doing something with no precedent, the frameworks become educated guesses at best.
- You're using frameworks to avoid the uncomfortable thing. Usually that's talking to customers, firing someone, admitting the idea doesn't work, or making a decision with incomplete information.
- The frameworks are contradicting each other and neither side is clearly right. Some tensions are real worldview differences (customer-centric vs product-centric, niche vs broad). You pick one and commit. No rubric resolves that for you.

**The meta-rule:** Frameworks help you think more clearly. They don't think for you. If you scored a 9/10 on a rubric but your gut says something is off, trust the gut and investigate. The rubric caught the easy problems. The hard ones are yours.

---

## Quick Reference: Which Skill for What

| Your Situation | Start With | Then |
|---|---|---|
| "Nobody's buying" | This diagnostic (figure out WHY) | Route to the right skill |
| "I have an idea but haven't talked to anyone" | mom-test | four-steps |
| "People like it but won't pay" | monetizing-innovation | 100m-offers |
| "Our website doesn't convert" | storybrand | made-to-stick |
| "We can't find customers" | traction | 100m-leads |
| "Competitors are eating our lunch" | obviously-awesome | blue-ocean-strategy |
| "Sales calls go nowhere" | spin-selling | influence |
| "We have early users but can't grow past them" | crossing-the-chasm (only if 10+ paying customers) | traction |
| "Should we pivot?" | lean-startup | four-steps |
| "Everything feels broken" | This diagnostic | Then one skill at a time |
| "Customers buy once and disappear" | money-models | 100m-offers |
| "Ads work but we can't afford to scale them" | money-models | 100m-leads |

---

## Scope and Limitations

### What This Diagnostic Does
- Routes you to the right framework faster than guessing
- Catches the most common misdiagnosis patterns
- Tells you when to stop using frameworks entirely

### What It Doesn't Do
- It doesn't replace judgment. The diagnostic narrows the options. You still decide.
- It assumes the 15 available skills cover your problem. Some problems (hiring, fundraising, legal, operations) aren't covered here.
- It can't diagnose problems you're not honest about. If you skip the hard questions or answer with what you wish were true, the routing breaks.
- It oversimplifies by design. Real startups have 3 problems at once. This makes you pick one to fix first, which is usually correct but sometimes the problems are entangled and need to be solved together.

### The Honest Warning
A diagnostic that always gives an answer is more dangerous than one that sometimes says "I don't know." If your situation doesn't fit any of the decision paths above, that's a signal — not a bug. Go talk to customers, advisors, or anyone who'll give you an honest read on what's happening. Then come back.

© getagentseal · MIT · getagentseal/founder-playbook

Similar skills

All skills for Agent setup: memory, context, orchestration →

diagnose by other authors comes first.

diagnose official github This skill audits an AI workflow across five dimensions and returns scores with prioritized fixes. Use it before launch or after major workflow changes. 209installs diagnose LegendApp A skill that investigates a bug through falsifiable hypotheses, discriminating probes and recorded evidence, then reports how solid the answer is. CX Codex +1 423installs diagnose-fix-loop LegendApp A skill that keeps the agent looping: diagnose, make one scoped fix, verify with the same signal, diagnose again. It targets causes, not symptoms. CX Codex +1 420installs recovering-from-failure RefoundAI A skill that walks you through why a product stalled and whether to pivot, turn around or shut it down. CX Codex +1 328installs startup-design ferdinandobons Walks a startup idea through intake, market research, strategy, brand, product, financials and validation experiments, saving files as it goes. CX Codex +1 806installs sales-forecast-diagnostic Maya-Beth Finotti A skill that investigates a missed or distrusted sales forecast and names the root cause with evidence from the CRM record. CX Codex +1 21,200installs startup-financial-modeling Seth Hobson Build startup financial models with revenue, costs, cash flow, and scenarios. Use it for planning runway, headcount, or a seed and Series A raise. CX Codex 12,585installs market-sizing-analysis Seth Hobson Calculates TAM, SAM, and SOM for market opportunities with three methods. Use it to test a venture idea, estimate addressable revenue, or build pitch analysis. CX Codex 11,715installs

From the same set3

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor