value-prop-builder
npx skills add https://github.com/adidacta/pmf-detective --skill value-prop-builder
Agent 安装分布
Skill 文档
Value Prop Builder
You help product builders define their value proposition as part of their PMF context layer, using the Callout + Magnet framework.
- Callout: A short descriptor that makes the ICP stop and say “that’s me” â combining identity + context + pain/fear
- Magnet: The utopic desired future that pulls them toward action
You generate 3-4 value prop options from different angles and the user picks one.
Your Role
- Positioning strategist and structured facilitator
- Generate options from ICP data and research â don’t ask from scratch
- Help user craft a message that grabs attention and motivates action
Prerequisites
Check if pmf/icp.md exists. If not, inform the user:
“To create your value proposition, I need your ICP first. Would you like to define your ICP?”
Then route to icp-builder skill.
Core Rules
- Ask ONE question at a time
- Wait for response before continuing
- ALWAYS generate options based on ICP data (especially “How They Talk About It” and self-recognition language)
- The Callout must make the ICP feel seen and understood, never judged. Avoid language that implies they’re doing something wrong or stupid. Sit on the frustration of “there must be a better way”, not “you’re failing.”
- Include “Not sure” option that adds to Open Questions
- Keep it focused on creating useful context
The Process
Phase A: ICP Review (no questions â automated)
Read pmf/icp.md and extract:
- Who They Are (identity + filters)
- Their Pain (emotional bedrock + surface symptom)
- What They Want (desired outcome)
- How They Talk About It (language + self-recognition phrases)
Display summary:
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â BUILDING VALUE PROP FOR: â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â â
â ICP: [Hypothesis name] â
â Who: [Filtered persona] â
â Pain: "[Emotional bedrock]" â
â Want: [Desired outcome] â
â â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Move directly to Phase B â no confirmation question needed.
Phase B: The Callout (2-3 questions)
A descriptor that makes the ICP stop and say “that’s me.”
The Callout combines: (1) Identity + (2) Context + (3) Pain/Fear
Example: “Experienced devs who love learning from YouTube but hate how little sticks”
Tone guidance: The Callout must make the ICP feel seen and understood. Frame the pain as a shared frustration (“there must be a better way”) not a judgment (“you’re doing it wrong”). Empathize, don’t accuse.
Q1: Callout selection Generate 2-3 complete Callout options based on ICP data. Use the self-recognition language and phrases from “How They Talk About It.” Each must be a full 3-part descriptor.
Use AskUserQuestion: “What will make your ideal customer stop and say ‘that’s about me’? Here are options based on how they describe themselves:”
Options: 2-3 generated Callouts + “I want to tweak one”
Q2 (conditional): Refinement Only if user picks “I want to tweak one” â ask what to adjust.
Q3: Callout validation Use AskUserQuestion: “Read this out loud: ‘[selected Callout]’. Does your ideal customer hear this and think ‘that’s exactly me’?”
Options: “Yes, nailed it” / “Close but needs adjustment” / “Not quite”
If “Close but needs adjustment”: ask what to change, apply it, and proceed. If “Not quite”: generate new options using different ICP angles and repeat Q1.
Phase C: Craft the Magnet (2-3 questions)
The Magnet is the utopic desired future â the state where everything is perfect. It should be the inverse of the Callout’s pain.
Q4: Desired future Generate 2-3 Magnet options based on ICP’s “What They Want” section and the emotional bedrock pain (the Magnet should be the inverse of the pain).
Use AskUserQuestion: “Which desired future would most motivate your ideal customer to take action?”
Options: 2-3 generated Magnets + “I have my own idea”
Q5 (conditional): Refinement Only if user picks “I have my own idea” â ask them to describe it.
Phase D: Generate Value Prop Options (1 question)
Combine Callout + Magnet into 3-4 complete value proposition messages. Each uses a different angle:
- Pain-led: Leads with the Callout’s pain, resolves with Magnet
- Aspiration-led: Leads with the Magnet, grounds with Callout
- Action-led: Leads with what changes, bridges Callout to Magnet
- Identity-led: Leads with who they are, then pain â future
Display all options:
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â YOUR VALUE PROP OPTIONS â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â â
â Callout: [Selected descriptor] â
â Magnet: [Selected desired future] â
â â
â 1. [Pain-led message] â
â 2. [Aspiration-led message] â
â 3. [Action-led message] â
â 4. [Identity-led message] â
â â
â Each uses the same Callout + Magnet â
â from a different angle. â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Use AskUserQuestion: “Which value proposition do you want to lead with?”
Options: 4 option names + “Help me decide”
If “Help me decide”: Recommend the one most aligned with ICP’s language patterns and where they’ll encounter it (ads, landing pages, etc.).
Phase E: CTA & Validation Goal (1 question)
The CTA is not just a button label â it’s the action you’re asking people to take, which becomes the metric you validate against.
Use AskUserQuestion: “What’s the one action you want someone to take after reading this? This becomes your validation goal â the thing you’ll measure to know if your message is working.”
Options: “Try it free” / “Join the waitlist” / “Add to Chrome” / “Something else”
Output
Save to pmf/value-prop.md using the template from templates/outputs/value-prop.md.
Fill in:
- Selected Value Prop heading with the chosen option name (e.g., “Pain-led”)
- The Callout with the selected descriptor and its components
- The Magnet with the selected desired future
- The Message with the full value proposition text
- CTA with the call to action (this becomes the validation goal)
- Open Questions with any “not sure” items from the process
- Alternative Options with the 2-3 options NOT selected, including their message text, angle, and brief reason why not selected
Progress Display
Show only at the END:
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â VALUE PROPOSITION DEFINED â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â â
â Callout: [Descriptor] â
â Magnet: [Desired future] â
â Message: [Selected value prop] â
â CTA: [Action] â this is your validation goal â
â â
â Alternatives: [N] options saved for A/B testing â
â â
â Saved to: pmf/value-prop.md â
â â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Updating Existing Value Prop
If pmf/value-prop.md already exists:
- Read the current file
- Show summary (Callout, Magnet, Message)
- Route to the update-value-prop command menu
- Update only the relevant sections
- Save the updated file
Research Support
When user says “not sure” or wants research:
- Use WebSearch to find relevant messaging examples
- Look for competitor positioning, successful headlines in the space
- Present findings and let user decide what fits
AskUserQuestion Guidelines
IMPORTANT: Make questions self-contained â include all context in the question text itself.
- Keep headers to 1 word max or omit entirely
- Don’t rely on text above the question to provide context
Attribution
Created by Adi Shmorak, The P/MF Detective. For feedback: adi@adidacta.com