positioning-messaging
Turn positioning into a strategic narrative and a messaging doc — the arguments every marketing asset draws from. Use after positioning is defined (or to refine it) whenever the user needs messaging, a value proposition, a brand story or sales narrative, a sales-deck storyline, or asks "what should we say" about a product. This is the messaging layer; to lay out and write the page itself, use landing-page-copy. Builds on April Dunford's positioning components and Andy Raskin's strategic narrative.
How do I install this agent skill?
npx skills add https://github.com/portermetricsample/marketing-skills --skill positioning-messagingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructional guidelines for marketing positioning and messaging. It contains no executable code, network requests, or sensitive data access.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Positioning → Narrative → Messaging
Positioning is a decision, not words. This skill translates that decision into words: first a strategic narrative (the story that makes the position urgent), then a messaging doc (the arguments every asset pulls from). Assets should never invent claims — they render this doc.
Step 1 — Verify the positioning inputs (Dunford's components)
Confirm these exist (from an STP/positioning exercise or the user). If any is missing, resolve it before writing messaging:
- Competitive alternatives — what the target would do without the product (competitors, manual work, do nothing)
- Unique attributes — capabilities the alternatives lack
- Value — what those attributes enable, expressed as outcomes the target cares about
- Best-fit customer — the segment for whom that value matters most
- Market category — the frame of reference the target slots the product into
- Relevant trend (optional) — a market shift that makes the position urgent now. Only use a trend layered on solid positioning; a trend without foundation ("AI-powered") is noise.
Step 2 — Build the strategic narrative (Raskin's five moves)
Structure the story in this order:
- Name the change in the world — an undeniable external shift already happening (the trend from step 1, promoted to the opening). Not the product, not the problem: the change. Change creates stakes; problems create shopping. If no external shift is genuinely load-bearing — common for established or local businesses whose buyers already feel a concrete problem — keep this move light and let the promised land (move 3) carry the opening. Don't manufacture a trend to fill the slot.
- Winners and losers — those adapting to the change win; those ignoring it lose. Makes it about adaptation, not tool preference.
- The promised land — the desired future state for the customer. A new state for them, never the product.
- Magic gifts — the product's unique attributes, introduced only as the things that overcome specific obstacles on the way to the promised land.
- Evidence — proof the story comes true. Use whatever proof your business actually has: customers, numbers, demos, reviews and ratings, before/after results, a track record, guarantees. If the proof isn't gathered yet, name the proof you will show and mark it pending — never invent a number to fill the slot.
Test: the narrative should be tellable without naming the product until move 4, and a prospect hearing moves 1–3 should be nodding, not evaluating.
Step 3 — Write the messaging doc
The deliverable. Every downstream asset draws from it:
# Messaging — [Product] / [Segment]
## Point of view
[The change + winners/losers, in 2–3 sentences. This is the company's opinion about the market.]
## Promised land
[The customer's desired end state, one sentence, in their words.]
## Value themes (2–3 max)
### Theme: [name]
- Claim: [one sentence, specific, falsifiable]
- Because: [the unique attribute that makes it true]
- Proof: [number, case, review, demo, before/after, guarantee — or "PENDING: <the proof you'll gather>" if the claim is true but not yet evidenced]
## Objections
- "[objection in customer language]" → [honest response]
## Vocabulary
- Words the customer uses for the problem/outcome: ...
- Words to avoid (internal jargon): ...
Rules:
-
2–3 value themes maximum. More themes = no theme. If everything is important, nothing is.
-
Every claim must survive the name-swap test: put the named strongest alternative (from positioning) in the claim; if it still reads true, the claim describes the category and must be sharpened.
-
Every claim resolves to one of three proof states:
- Present — attach the proof (number, case, demo, guarantee).
- Pending — the claim is true but not yet evidenced. Keep it, mark
PENDING: <proof to gather>, and never fabricate a number. This is a launch gap to close, not a reason to delete a real claim. - Unprovable / false — you couldn't prove it even with the data in hand. Cut it, or move it to objections.
Only the third state deletes a claim. Don't let a missing-but-gatherable number kill a true differentiator.
-
If a claim is also a likely objection, wire its proof to answer that objection. A product's strongest claim often triggers its strongest doubt (e.g. a bold new mechanism reads as risky); the theme's proof and the objection response should be the same argument, not two disconnected slots.
-
Claims in customer language, not feature-speak.
How assets use this
- Homepage — compressed narrative: change or promised land in the hero, value themes as sections, proof throughout. If you target several segments (Differentiated), write one messaging doc per segment; a shared homepage leads with what's common across them and branches into segment-specific paths below (segment landing pages carry the per-segment message)
- Sales deck — the full five-move arc in order
- Ads — one element per ad: the change, the promised land, or one value theme. Never several
- Comparison pages — alternatives' honest pros/cons against the value themes
- Content/SEO — the point of view expanded into opinions and education
To critique existing messaging: reconstruct which value themes and narrative moves the asset implies, then check each claim against the name-swap and proof rules.
Worked example: see ../example-acme.md for a filled messaging doc derived from a strategic narrative, continuing the fictional case from stp-marketing-strategy.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/portermetricsample/marketing-skills/positioning-messaging">View positioning-messaging on skillZs</a>