1---2name: positioning3description: >-4 Decides what a B2B SaaS company is compared to, what only it has, who cares most and the market category it should5 be judged in, from its own won and lost deals and buyer evidence. Every attribute needs proof and every segment6 needs a win-rate pattern, so a crowded market gets a position the evidence supports. Returns NEW, KEEP, REVISE,7 NEEDS DECISION, NEEDS EVIDENCE or BLOCKED and writes the result into the profile's Positioning section. Use it8 before a messaging house, a homepage rewrite or a category decision, or when win rates shift. Not for writing9 taglines or pillars (use messaging-house) or for finding the moments that start a search (use buying-moments).10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Uses a connected CRM or call recorder if13 the agent has one, otherwise exports or pasted deal notes. Python 3 is optional, for the deal counts.14metadata:15 author: SHAKEUP16 version: "1.0.0"17 stage: decide18 plugin: strategy-messaging19 homepage: https://www.shakeuphq.com/skills/positioning20---21 22# Positioning23 24Finds the frame a B2B SaaS company wins in, from the deals it actually won and lost, so every message after it stands on proof.25 26## Purpose27 28- One job: decide the 5 positioning fields (competitive alternatives, unique attributes, value, best-fit customers, market category) from evidence, and write them to `## Positioning` in `company-profile.md`.29- Stage: decide. It ends in a verdict.30- It never invents a win rate, a customer, a competitor fact or a proof. It never writes copy: headlines, taglines and pillars belong to `messaging-house`.31- It never picks a category because it sounds bigger or newer. The category is the one the evidence says the company wins in.32 33## Use when / not34 35| Situation | Use |36| --- | --- |37| No positioning yet, or it was written from opinion | this skill |38| Win rates or deal mix changed, a new competitor shows up in deals, or the product changed | this skill, to confirm or revise |39| A messaging house or homepage rewrite is next | this skill first, then `messaging-house` |40| You need the ICP, the buying group and the moments that start a search | `buying-moments` (run after this skill; it reads best-fit customers) |41| You need copy tested on buyers | `message-test` |42| Filling the rest of the profile | `company-profile` |43 44## Inputs45 46| Input | Required | Ways to provide, in order | If missing |47| --- | --- | --- | --- |48| Won and lost deals, last 12 months: outcome, what they compared or lost to, why, segment fields, deal size, cycle | yes (won deals at least) | a connected CRM (closed-won, closed-lost, loss reason, competitor field); a CRM export (CSV); a pasted table; the reader's account of the last 10 deals, labelled `recalled` | `NEEDS EVIDENCE`, with the exact report to pull |49| Buyer evidence: win and loss interviews, call transcripts, sales notes, reviews | no | a connected call recorder or CRM notes; uploaded transcripts; pasted excerpts | value stays `inferred`; coverage `partial` |50| Competitor facts (what each alternative does and lacks) | no | the competitors' own pages and docs, if the agent can browse; pasted pages | uniqueness stays `unverified` against that alternative |51| Product facts | yes | `## Product` in the profile; the product site; pasted docs | ask once |52 53## Profile read54 55From `company-profile.md`: `## Company` (category, business model, ACV, sales cycle), `## Product`, `## Buyers` (ideal customer, bad fit), `## Positioning` (the current one, if any), `## Claims and proof`, `### Never say`, `## Competitors` (mention policy and how buyers compare), and every `## Learnings` entry for `positioning` with status `noted`, `fact` or `accepted`.56 57No profile: ask in one message for what the product does, who it sells to, and the deal list (or the last 10 deals from memory). Say that `company-profile` saves this step next time.58 59## Steps60 611. **Apply learnings.** Read the learnings for this skill first. An accepted learning overrides the default rule it names; say so in the output when it fires.62 632. **Build the evidence table.** Give every item an id: `D1` for deals, `I1` interviews, `C1` call notes, `R1` reviews, `N1` sales notes. For each deal record: outcome, alternatives (compared, used before, lost to), reason tags, segment fields (industry, size band, stack, region, sales motion), ACV, cycle days, the role that led the buy.64 - A `no decision` is a loss to the status quo. Count it as a loss; if it names no alternative, record `status quo` as its alternative.65 - A customer that churned in its first year counts against fit for its segment, not in the win rate.66 - A `recalled` deal counts, but a pattern that rests only on recalled deals is a hypothesis.67 68 Then run the counts, naming each segment column as it appears in the reader's headers:69 70 ```71 python3 scripts/deal_patterns.py --csv deals.csv --segment employees --segment crm72 ```73 74 Read the `warnings` first. A missing outcome, alternative or reasons column means the counts are wrong: rename that column (`outcome`, `alternative`, `reasons`) and run again.75 76 Without Python, count by hand: win rate = won / (won + lost + no decision); per alternative, the deals it appears in and the outcome of each; per segment value, deals, wins, win rate and one deal's swing (100 / deals, in points); per reason tag, the distinct accounts that gave it. Say which way you ran it.77 783. **Grade the evidence.**79 80 | Evidence | complete | partial | too thin |81 | --- | --- | --- | --- |82 | Won deals with a reason | 10 or more | 5 to 9 | under 5: with fewer, any 3-deal pattern is most of the sample, so it can't separate a segment from the whole base |83 | Lost or no-decision deals | 5 or more | 1 to 4 | 0: alternatives come from won deals only, so the loss side is blind |84 | Buyer words (interviews, transcripts, reviews) | 5 or more sources | 1 to 4 | 0: value stays `inferred` |85 86 Under 5 won deals ends at `NEEDS EVIDENCE` after step 9: finish the draft as a labelled hypothesis, but don't write it to the profile.87 884. **Name the competitive alternatives.** What would buyers use if the company didn't exist? Take them from the deals, not from the competitor list.89 - Always test the status quo forms: a spreadsheet or manual process, a feature of a tool they already pay for, hiring a person or an agency, doing nothing.90 - Keep an alternative that appears in 2 or more deals. Rank by appearances across won, lost and no-decision deals. The main alternative is the one that appears most often; on a tie, the one buyers chose in more lost and no-decision deals.91 - With 5 or more deals against an alternative, give the win rate against it. Below 5, write the count only.92 - Mark the market `crowded` when 3 or more products from other companies each appear in 2 or more deals. A feature inside a tool the buyer already pays for counts as one of those products. Step 8 then applies.93 945. **Test the unique attributes.** Candidates come from `## Product`, won-deal reasons, and what buyers said the alternatives lacked. Different must pass against the main alternative; against the next 2 alternatives, record pass or fail, because it shows which comparisons the attribute wins:95 96 | Test | Passes when | If it fails |97 | --- | --- | --- |98 | Different | the main alternative lacks it or does it measurably worse, shown by a competitor source or deal notes | table stakes: list it, never lead with it |99 | Proven | it has proof a buyer could check, from the first 4 kinds in `references/evidence-rules.md` (product fact, customer data with a source, a cleared customer, a third party). Deal reasons prove that it mattered, not that it's true | `claim to confirm`: keep it out until a source exists |100 | Mattered | it appears in won-deal reasons or buyer words from 3 or more different accounts | `unvalidated`: it can't carry the position |101 | Lasting | the alternative can't match it inside one sales cycle with a setting or a price cut | keep it, flagged `fragile` |102 103 A unique attribute passes Different, Proven and Mattered. Lasting only flags risk.104 105 Pick the lead attribute: one that passes all 4 tests (if none passes Lasting, the strongest of the rest, flagged `fragile`). On a tie, lead with the one named in more deals won against the main alternative, then the one named by more accounts.106 1076. **Write the value.** For each unique attribute, chain it: attribute, then what it lets the buyer do, then the result the buyer measures, in the buyer's words where you have them. Value needs buyer evidence (interviews, transcripts, reviews, or deal notes in the buyer's words) from 2 or more sources; with less, mark it `inferred`. An inferred value doesn't block a verdict; it makes coverage `partial`. Group the chains into 2 or 3 value themes. Each value line ends with its proof id.108 1097. **Find the best-fit customers.** Who cares most about that value?110 - Candidates: segment values with 5 or more decided deals whose win rate beats the overall rate by more than one deal's swing. The rule stops 1 lucky deal from defining the segment.111 - Rank by lift, then by median ACV of won deals, then by shorter median cycle.112 - Describe the segment by what makes it care, not only by firmographics: the situation, the trigger and the value theme that wins it ("clinic groups with 5 or more sites whose managers run a calendar per site"). Made-up example, not a real company.113 - Candidates from different segment fields that share half or more of the smaller one's deals (say "5 or more sites" and "on a shared practice system") describe one group. The larger is the best fit; the shared deals are its core, reported with their own counts.114 - Add the bad-fit pattern: segment values with churn, or with a win rate below overall by more than one deal's swing.115 - Compare with `## Buyers` Ideal customer. A best fit inside it is a narrowing: note it for `buying-moments`. A best fit outside it (most of its won deals fall outside the stated ideal customer) is a conflict: verdict `NEEDS DECISION`.116 - 2 candidates that share fewer than half their deals and sit within one swing of each other tie: verdict `NEEDS DECISION`.117 1188. **Apply the crowded-market rules** when step 4 marked the market crowded:119 - Position against the alternative buyers choose most often, which is often the status quo, not the loudest competitor.120 - Lead with the lead attribute from step 5. Move every shared attribute out of the lead.121 - Narrow the best-fit segment until its lift clears the swing rule. A narrower position that wins beats a broad one that ties.122 - Every comparative word in the fields ("only", "faster", "more") needs a proof that compares against a named alternative.123 - If no attribute passes, the company has a hypothesis, not a position: `NEEDS EVIDENCE`, with the evidence that would prove one.124 1259. **Choose the market category.** First match wins:126 127 | Condition | Frame |128 | --- | --- |129 | Buyers in won deals already name a category, and the win rate against that category's main vendors is at or above overall | Head to head in that category |130 | A known category exists, but wins concentrate in the best-fit segment for a reason that segment states | That category, narrowed: "<category> for <segment>" |131 | Buyers place the product in a category whose default buying criteria it loses on (the loss reasons are that category's checklist) | An adjacent category whose default criteria match the unique attributes |132 | No category in the buyers' words fits, and 3 or more buyers couldn't say what it was | A new category: `NEEDS DECISION`, because the company would fund the category's education, which takes longer and costs more than any other frame |133 134 Then test the chosen frame: buyers use the term (interviews, review-site categories, the reader's search data); the frame's default expectations match the unique attributes; the main alternative looks weaker or out of place inside it. A frame that fails 2 of the 3 goes back to the table. A test with no evidence either way is `untested`: it isn't a fail, but say so and mark coverage `partial`. Details and examples: `references/evidence-rules.md`.135 13610. **Add a market change only with a source.** Include a trend only when a source the reader can open shows it and it makes the value more urgent for the best-fit segment. Otherwise leave it out.137 13811. **Draft the section and compare.** Fill the 5 fields exactly as the profile template names them. Write the one-line statement `messaging-house` builds on: "For <best fit> who <problem>, <company> is the <category> that <value>. Unlike <main alternative>, it <lead attribute>." If the profile already has positioning, compare field by field: same, sharpened (same meaning, better evidence) or contradicted.139 14012. **Write it back.** After the verdict, per the stops below, replace `## Positioning` with the new fields. Each unique attribute and value carries its proof in brackets. Attributes that failed Proven go to open items for `company-profile` to record as claims to confirm, never into the section. If the agent can't edit the profile file (a chat app, or a profile pasted into the chat), give the section in one code block ready to paste and set `profile_section_written: false (ready to paste)`.141 142## Check and verdict143 144| Verdict | Condition (first match wins) |145| --- | --- |146| `BLOCKED` | No product description, or no deal or buyer evidence of any kind after asking once |147| `NEEDS EVIDENCE` | Fewer than 5 won deals; or no attribute passes Different, Proven and Mattered |148| `NEEDS DECISION` | The evidence-based best fit conflicts with the profile's ideal customer; or 2 segments or 2 frames tie; or the frame would be a new category |149| `REVISE` | The profile has positioning and the evidence contradicts at least 1 field |150| `KEEP` | The profile has positioning and every field holds against the evidence (wording may sharpen) |151| `NEW` | The profile had no positioning; every field is filled from evidence |152 153Named stops:154 155- `BLOCKED`: ask for the missing input, naming the CRM report to pull (closed-won and closed-lost, last 12 months, with loss reason and competitor).156- `NEEDS EVIDENCE`: stop. Show the draft labelled `hypothesis`, the tests it failed, and the evidence to collect (which deals, which interviews). Don't write the profile.157- `NEEDS DECISION`: stop. Show the 2 options side by side with the deals behind each, what each wins and what each gives up. Write nothing until the reader picks.158- `REVISE`: stop before overwriting. Show the old and new field by field with the evidence; write after the reader says yes.159 160`NEW` and `KEEP` write without a stop.161 162## Learn163 164Append to `## Learnings` in the profile:165 166- the reader picks the other option at `NEEDS DECISION`, or rejects a `REVISE`: a `proposal` with their reason;167- the positioning is set or changes (including a first `NEW`): a `fact` with the old (or none) and new category and best fit, so later runs know what changed and why;168- a result comes back, such as the win rate in the best-fit segment 2 quarters later, or `message-test` or a buyer panel showing buyers don't recognise the category: a `fact` with its source.169 170Example: `- 2026-10-24 | positioning | fact | Best fit narrowed from all clinics to groups with 5 or more sites | Why: win rate 82% vs 61% overall on 11 deals (reader's CRM, 2026-Q3) | Status: noted`171 172## Output173 174```175Verdict: <NEW | KEEP | REVISE | NEEDS DECISION | NEEDS EVIDENCE | BLOCKED> · Coverage: <complete | partial (what's missing) | blocked> · Counts: <script | by hand>176Evidence: <n> deals (<won> won, <lost> lost, <n> no decision, <n> churned), <n> buyer sources · Overall win rate: <n>% · Market: <crowded | not crowded>177 178Competitive alternatives179| Alternative | Deals | Won against | Lost to | Win rate against | Note |180 181Unique attributes182| Attribute | Different | Proven (proof id) | Mattered (accounts) | Lasting | Call |183 184Value185| Value theme | Attribute it rests on | Result the buyer measures | Proof |186 187Best-fit customers188| Segment | Deals | Win rate | Lift | One deal's swing | Median ACV won | Why they care |189Bad fit: <segments and the evidence>190 191Market category: <frame> because <the rule that fired>. Tests: buyers use it <yes/no>, expectations match <yes/no>, alternative weaker inside it <yes/no>192 193Statement: For <best fit> who <problem>, <company> is the <category> that <value>. Unlike <main alternative>, it <lead attribute>.194 195## Positioning (the section as written to the profile, or "not written: <stop>")196Competitive alternatives: ...197Unique attributes: ...198Value: ...199Best-fit customers: ...200Market category: ...201 202Changed from the profile: <field: old, new> (or "none" or "no previous positioning")203Learnings applied: <list, or none>204```205 206Then the handoff block.207 208## Hand off209 210```handoff211skill: positioning212version: 1.0.0213verdict: NEW214coverage: partial (no loss interviews; competitor docs not opened for 1 alternative)215for: <company>216outputs:217 main_alternative: a spreadsheet the operations team keeps218 lead_attribute: one calendar across every site219 best_fit: clinic groups with 5 or more sites220 market_category: scheduling software for multi-site clinic groups221 statement: For clinic groups with 5 or more sites who run a calendar per site, ...222 profile_section_written: true223next: [buying-moments, messaging-house]224open: [a source for "most flexible", or drop it]225```226 227Made-up values for illustration. For `NEEDS EVIDENCE` and `NEEDS DECISION`, `profile_section_written` is false and `next` is `[]` until the reader acts. `messaging-house` reads `statement`, `lead_attribute` and the written section; `buying-moments` reads `best_fit`.228 229## Failure modes230 231| Problem | Do this |232| --- | --- |233| The CRM has no loss reason or competitor field | Use call notes or ask the sales lead for the last 10 losses; mark those deals `recalled` |234| Every loss reason is "price" | Price is often the stated reason for a weak value case. Read the notes for what the buyer compared; if they compared a cheaper category (the status quo), the frame is the problem, not the price |235| The reader wants an attribute in that has no proof | Keep it out of the section; list it under open items as a claim to confirm, with the proof that would let it in |236| The founder rejects the result after seeing the deal evidence | The deals win. Show the gap with the deal ids; if the founder still disagrees, stop at `NEEDS DECISION`. A request to add an unproven claim is the next row, not this one |237| One big customer dominates the wins | Count accounts, not deals or revenue, for every pattern; note the account's share of won ACV |238| The reader asks for "the leading" or "the best" in the category | Not a position: there is no proof that compares. Use the lead attribute against the main alternative instead |239| Only won deals exist (a new company) | Alternatives come from what won customers used before; mark the loss side blind and coverage `partial` |240| The reader asks to write without waiting | Named stops hold. Show exactly what you would write and the choice it needs, then wait; don't pick for them |241 242## Influenced by243 244- April Dunford's positioning method from Obviously Awesome, where competitive alternatives, unique attributes, value, best-fit customers and the market category are worked out in that order: https://miro.com/templates/april-dunfords-positioning-template/ and https://www.aprildunford.com/books245- What we changed: every field must come from won and lost deals, an attribute must pass 4 tests (different, proven, mattered, lasting), a segment must beat the overall win rate by more than one deal's swing, crowded markets get their own rules, and the result is written into the company profile for the next skills to read. We don't use her canvas or wording.