value-prop-that-converts
Write a developer value proposition that is specific, provable, and free of puffery. Use when the messaging leans on \"powerful,\" \"better,\" \"seamless,\" or \"best-in-class,\" when claims have no proof, or when the same line is supposed to reach both the developer and the buyer.
git clone --depth 1 https://github.com/AIDevGTM/gtm-cofounder /tmp/value-prop-that-converts && cp -r /tmp/value-prop-that-converts/skills/06-value-prop-that-converts ~/.claude/skills/value-prop-that-convertsSKILL.md
# The value prop that converts
> "Better" is sloppy thinking. Better how, along what dimension, by how much, proven by whom? Developers test every claim you make. Give them numbers or give them nothing.
**Use this when:** your value prop contains puffery, your claims aren't attributed, or you're trying to make one sentence do the job of two audiences.
## The core idea
Developers have a finely tuned BS detector and they *will* verify you. Specificity is credibility. Every strong dev value prop is: **specific + provable + spoken in their language.**
## Framework: the value-prop rules (Frankl)
1. **Never say "better."** Say better *how*, by *how much*, versus *what*.
2. **Time savings must be specific.** ❌ "saves developer time" · ✅ "8× faster builds, 2 hrs → 15 min" (attributed).
3. **Two kinds of time, speak to both:**
- **Chronos** (Alpha Dev): clock hours saved per week.
- **Kairos** (Empowered CTO): calendar time, weeks off a release cycle, competitive edge.
- The same product must land both. *"Release fast or die"* worked for developer *and* CTO.
4. **Every claim needs proof.** A demo is the *weakest* proof (ideal conditions). An **attributed testimonial** (name + title + company + number) is the strongest. Anonymous quotes are assumed invented.
5. **Sell the category, not the solution.** Talk about the problem and the need for "a tool like this"; don't proactively pitch features; it trips developer defenses.
6. **Never "pleased to announce" / "excited to share."** No one cares how you feel.
## Framework: the three dimensions of a dev value prop (Czakon)
A complete value prop answers all three, fast:
- **What is it?**: category / known-incumbent comparison / plain statement ("a Datadog alternative," "CI for monorepos").
- **For whom / what use case?**: the ICP and the job (from `who-is-this-for`).
- **Why you over the 10 alternatives?**: the legitimate, provable reason to exist.
Headline = *what is it.* Subhead = *for whom / what job.* For dev tools, weight the **how** over the **why**. Developers often already know why they hurt.
## The puffery detector: flag and replace
| Banned | Why devs discount it | Replace with |
|---|---|---|
| Powerful | everyone claims it | the specific thing it does |
| Easy to use | they'll test it in 60s | time-to-value with a number |
| Best-in-class | says who, by what metric | the source or the number |
| Seamless integration | unprovable in the abstract | named integrations + logos |
| Industry-leading | says nothing | real share / user counts |
| Platform | hears: integration headache | the one job it does |
| Revolutionary / cutting-edge | pure air | name the actual technology |
## Proof hierarchy (weakest → strongest)
```
your claim < a demo < a benchmark you ran < a named user's attributed result
```
Spend your effort at the right end.
## Mistakes that look reasonable
- **Adjective stacking**: "powerful, seamless, intuitive." Three words, zero information.
- **One line, two audiences**: a Chronos-only message loses the buyer; a Kairos-only message loses the adopter.
- **Unattributed social proof**: "developers love us." Which developers? At which company?
- **Leading with the why**: for most dev tools the pain is known; lead with the *how* and the proof.
## Your next 30 minutes
- [ ] Run your homepage copy through the puffery table. Delete or replace every hit.
- [ ] Rewrite your #1 claim with a **number** and an **attribution** (even a single named user).
- [ ] Write one Chronos line (hours/week) and one Kairos line (weeks/release). Make sure both exist.
- [ ] State your value prop as the three dimensions: *what · for whom · why you.*
---
Built from real dev-tool GTM experience, with frameworks from Adam Frankl (*The Developer-Facing Startup*) and Jakub Czakon (*markepear.dev*).
When a framework can't make the call, that's what a human is for: [The DevTool GTM Company](https://thedevtoolgtmcompany.com).Interview the user once and write a docs/gtm-cofounder/founder-brief.md that every other skill reads first, so the advice is about their real business, not a textbook. Use this before anything else, or whenever the agent lacks context on the user's product, ICP, market, or stage, or is giving generic GTM advice.
After the founder brief, turn it into an honest diagnosis and a prioritized, stage-aware GTM roadmap saved as docs/gtm-cofounder/gtm-roadmap.md. This is the hub the user returns to every session to see where they are and the single next move. Use right after start-here, whenever the user doesn't know what to work on next, wants a plan instead of a one-off task, or is drowning in disconnected tactics.
Define a real ICP and the developer personas in the sale. Use when the user says the product is \"for developers,\" can't name who would say no, or is marketing to whoever holds the budget instead of who actually adopts.
Run developer customer discovery via a Technical Advisory Board (TAB). Use when the user has never interviewed a user who isn't a friend, is inventing messaging from a conference room, or is guessing at the roadmap instead of hearing the pain firsthand.
Build a positioning and narrative where the developer is the hero and a real trend is the villain. Use when the messaging describes the product instead of the problem, sounds like every competitor, or has no urgency because nothing is at stake.
Position an AI product when everyone claims AI and skeptics call it \"just a wrapper.\" Find the real wedge (data, workflow, trust, domain), make reliability the differentiator, answer \"won't the big labs just build this,\" and stop leading with \"AI-powered.\" Use when your AI or dev tool blends into a sea of similar demos, buyers doubt the accuracy, or you can't say why you win when the model is a commodity.
Structure a dev-tool homepage that converts developers into champions. Use when the landing page is written for the buyer instead of the developer, reads as salesy, buries what the product does, or makes it hard to start. Pairs with the ShipReady homepage audit.
Turn a curious developer into an activated one: the docs, the quickstart, and the first-run experience that gets them to their first real win fast, and back again. Use when people sign up or star the repo but never get it working, come once and never return, or you're about to pour traffic into a first-run that leaks.