positioning-and-messaging
Develops positioning and messaging for B2B products by mapping target customers, competitive alternatives, and differentiation, then builds messaging…
Identity proven by GitHub's verified organisation badge (writer)
- Agents
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, claude.ai and API
- License
- CC0-1.0 (permissive)
- Pin
- 20837c9pinned Oct 9, 2026
- Context cost
- about 1,800 tokenswhen the skill loads
- GitHub stars
- 8on writer/skills
- Scripts
- None found
What it does
“Positioning, messaging and voice for enterprise B2B products and brands. Builds positioning (target, alternatives, differentiation, category), messaging houses with pillars and proof, persona-, role- and industry-specific messaging, value propositions, boilerplate and elevator pitches, and brand or executive voice guides extracted from real writing samples. Use it whenever the user says the message "isn't landing" or "sounds like everyone else", wants to position against competitors, launch into a new segment, write a value prop, tagline or messaging framework, or capture how a brand or executive writes. Also use it when copy feels generic because the positioning underneath is unclear and any competitor could say the same thing.”
Generated summary from the skill's own text
Develops positioning and messaging for B2B products by mapping target customers, competitive alternatives, and differentiation, then builds messaging frameworks with audience-specific variants, proof points, and voice guides. Extracts brand or executive voice from writing samples to ensure consistency across all customer-facing copy.
When to use it
- Positioning feels generic or competitors could claim the same thing
- Launching into new market segments or customer personas
- Building messaging frameworks with pillars and proof points
- Capturing how a brand or executive actually writes
When not to
- You have strong positioning and need to turn it into specific marketing assets
- Reviewing final copy for grammar or style only
Install
These commands install from the publisher's repository and need no account.
skills CLI
npx skills add writer/skills --skill positioning-and-messagingInstalls from the repository's default branch, which may have changed since the commit we checked.
GitHub CLI 2.90 or later
gh skill install writer/skills positioning-and-messaging@20837c912ac6df73f78119b7075678f122083a34Installs the commit we checked (20837c9).
Copy by hand
Download the folder at 20837c9 and put it in .claude/skills/positioning-and-messaging for Claude Code and in .agents/skills/positioning-and-messaging for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.
Copy for your agent
A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.
Prompt
Install the agent skill "positioning-and-messaging" by Writer. Source, pinned to commit 20837c912ac6df73f78119b7075678f122083a34: https://github.com/writer/skills/tree/20837c912ac6df73f78119b7075678f122083a34/skills/positioning-and-messaging 1. Download that folder at exactly this commit. Do not use the default branch. 2. Copy every file unchanged, keeping the folder structure, into .claude/skills/positioning-and-messaging/ for Claude Code and .agents/skills/positioning-and-messaging/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist. 3. Do not edit the files, and do not run any script in the folder unless I ask you to. 4. When you are done, list the files you copied and where you put them. Listing and checks: https://www.agentnative.dev/skills/writer/positioning-and-messaging
SKILL.md at the pin
--- name: positioning-and-messaging description: Positioning, messaging and voice for enterprise B2B products and brands. Builds positioning (target, alternatives, differentiation, category), messaging houses with pillars and proof, persona-, role- and industry-specific messaging, value propositions, boilerplate and elevator pitches, and brand or executive voice guides extracted from real writing samples. Use it whenever the user says the message "isn't landing" or "sounds like everyone else", wants to position against competitors, launch into a new segment, write a value prop, tagline or messaging framework, or capture how a brand or executive writes. Also use it when copy feels generic because the positioning underneath is unclear and any competitor could say the same thing. --- # Positioning & Messaging Positioning decides who you're for and why you win. Messaging is how you say it to each audience. Voice is how it sounds. Get them in that order. Polishing copy on top of fuzzy positioning produces nice-sounding sentences any competitor could sign. ## 1. Positioning **Inputs needed (ask once if missing):** - what the product actually does (from the user's company-and-offer file; its location is in the project instructions) - best customers and why they bought - deals lost and why - the real alternatives buyers consider - current messaging Without real customer evidence, label the output **"hypothesis positioning — validate with 5+ customer and prospect conversations"**. **Five questions.** Each answer must be specific before moving on: 1. **Who exactly?** The role, company type and situation where we're the obvious choice. Example: "Heads of eCommerce at multi-brand CPG companies selling through 5+ retailers", not "marketing teams". 2. **What problem, triggered by what?** The pain, the event that makes it urgent, and the cost of doing nothing. 3. **Compared to what?** The real alternatives buyers weigh: named competitors, the status quo, building in-house, agencies, spreadsheets and manual work. 4. **Why us, and only us?** Fill in: "Only we ___ because ___." Test it: could a competitor say this truthfully? If yes, it's not a differentiator. 5. **So what?** The outcome, at the strongest proof level available: - Proof level 1: a measured result from the proof library. - Proof level 2: a named qualitative change. - Proof level 3: directional. **Competitive alternatives map:** | | Us | Competitor A | Competitor B | Build / status quo | |---|---|---|---|---| | Best for | | | | | | Approach | | | | | | Tradeoff | | | | | | **They win when…** | | | | | Fill in "They win when" honestly. The sweet spot is where we clearly win, competitors can't or won't follow, and the tradeoff is one our target buyers happily accept. **Statement:** "For [target] who [problem/trigger], [product] is the [category] that [key benefit]. Unlike [named alternatives], we [differentiator], because [reason to believe]." **Five-check test:** - **Specific:** names a who and a what. - **Differentiated:** passes the "could a competitor say it" test. - **Credible:** backed by proof we actually have. - **Meaningful:** the buyer cares. - **Memorable:** survives retelling. **Category choice:** - **Existing category:** easier to buy, harder to stand out. - **Sub-category:** "X for Y". Often the best enterprise choice. - **New category:** expensive, and only worth it if we can fund educating the market. Recommend one and explain the tradeoff. ## 2. Messaging house ``` Positioning statement (internal) Core message (one sentence, external) Pillars (3) — each: claim · why it matters to the buyer · 2–3 proof points (proof-library IDs) · what we never say Messaging by audience — economic buyer / functional owner / technical & security / end user; and by priority industry Hierarchy — tagline (<10 words) · value props (3–5 one-liners) · elevator pitch (~75 words) · boilerplate (100–150 words) Don't-say list — overclaims, banned terms, competitor references policy ``` **Rules:** - **Every pillar needs proof.** A pillar without proof is an aspiration. Label it so, and keep it out of external claims until proof exists. - **Use the customer's words.** Mine discovery notes, call transcripts, win/loss interviews, reviews and RFP language. Phrases buyers already use beat invented copy. - **Audience variants change the emphasis and proof, not the facts.** The CFO hears payback and risk, IT hears architecture and security, the practitioner hears workload. All of them hear the same core claim. **Message testing:** - **Best:** real conversations and A/B tests with enough volume. - **Acceptable for early direction:** synthetic panels, structured critique, or "could a competitor say this?" reviews. Label them **SYNTHETIC — directional only**, and never report synthetic results as customer data. **Scoring a message** (1–5 each): - clarity - relevance to the persona's priority - credibility (proof) - differentiation - urgency, meaning a genuine reason to act ## 3. Voice extraction (brand or executive) Use this to fill in the user's brand-voice-and-restrictions file (template in this skill set's `context-templates/`), or to create an executive ghostwriting profile. **Sample gate:** at least 3 samples and roughly 500+ words. Prefer the most natural writing first: 1. casual email and internal messages 2. call or podcast transcripts 3. LinkedIn posts and articles 4. polished web copy and press releases, which are the most edited and the least personal Exclude legal text and other people's quotes. State what was used: "N samples, ~W words, excluded: …". **Extract (quote exact phrases, and cite the sample each came from):** - **Core stance:** teacher, challenger, straight-shooter, or guide; energy level; recurring themes. - **Scales (1–10):** formality, energy, technical depth, boldness (hedged ↔ direct). - **Rhythm:** sentence length and variation, paragraph length, use of lists vs. prose. - **Openings, closings and transitions** they actually use. - **Signature phrases**, verbatim. - **Absence signals:** words, punctuation, structures and tones that never appear, with counts (e.g., "em dashes: 0 in 6 samples"; "never opens with a question"). - **Label absences from small samples as provisional.** Only prohibitions the person states are firm rules. - **For executives, confidence zones:** where they speak with full authority, where they say "in my experience", where they're exploring. Never write them into more certainty than they hold. - **Contradictions between samples:** note them; don't smooth them over. **Output:** a voice guide of about 500 words or fewer containing: - "We sound like / we never sound like" - the scales - rhythm - openers and closers - signature phrases - off-limits words and moves - channel shifts - 2 short before/after examples **Validation:** write a short passage in the extracted voice (A) and one deliberately off-voice (B). Ask the person: "Does A sound like you on a good day?" Refine from their answer. **Rules:** - Ghostwritten executive content must use the executive's real experiences and views. - Never invent anecdotes, numbers or opinions. - The executive approves before anything is published. ## 4. Voice audit of an existing draft - **Fix in order:** banned or restricted words → tone → sentence patterns → persona. - **Who fixes what:** - Surface issues (words, punctuation, capitalization) are fixed directly. - Structural issues (rhythm, hierarchy) are flagged with a suggested fix. - Semantic issues (persona, emotional register) go to a human. - **Approved claims and legal wording stay verbatim,** even when they sound off-brand. A rewrite that changes a fact is flagged, not shipped. - **Channel rules beat voice.** For example, retailer listing rules win; log the exception. - **Never make readability worse.** - **Report each finding as:** location · dimension · severity · original · issue · fix. ## Handoffs - Comparison pages and battle cards: `competitive-and-objections`. - Turning messaging into assets: `b2b-content-and-campaigns` and `pdp-content`. - Review before anything goes external: `customer-facing-quality-gate`.
From writer/skills at 20837c9, shown as plain text under its license: CC0-1.0 (permissive). The license text is in LICENSE.
View SKILL.md on GitHub at 20837c9Files
- SKILL.md8.2 KB · 07684b3b83c0
1 file, 8.2 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.
Skill folder on GitHub at 20837c9More from Writer
agent-execution-receipts
This skill inspects signed execution receipts and correlates them with provider audit logs to determine whether an agent action has local evidence, a…
Claude Code, Codex, Cursor +4 · about 290 tokens · pinned 6 days ago
practice-registry
This skill checks Scala, Python, TypeScript, JavaScript, and Rust code against company-specific coding practices before generation, during editing, and before…
Claude Code, Codex, Cursor +4 · about 410 tokens · pinned 6 days ago
account-targeting-and-research
This skill helps sales and marketing teams identify and research enterprise accounts most likely to buy.
Claude Code, Codex, Cursor +4 · about 2.6K tokens · pinned 6 days ago
b2b-content-and-campaigns
This skill helps the agent create enterprise B2B marketing content and campaigns, including case studies, executive thought leadership, email programs, web…
Claude Code, Codex, Cursor +4 · about 1.4K tokens · pinned 6 days ago
business-case-and-proposal
This skill helps agents construct enterprise business cases, ROI and TCO models, executive summaries, proposals, RFP responses, security questionnaires, and…
Claude Code, Codex, Cursor +4 · about 2.3K tokens · pinned 6 days ago
competitive-and-objections
This skill equips agents to build honest competitive battle cards, handle sales objections, and analyze win/loss outcomes.
Claude Code, Codex, Cursor +4 · about 2.5K tokens · pinned 6 days ago
Related in Marketing, sales and product
accelo-automation
This skill enables agents to automate Accelo project management tasks by discovering and executing operations through Composio's Accelo toolkit via Rube MCP.
by ComposioOfficial publisher
Agents not labelled yet · about 690 tokens · pinned 6 days ago
acculynx-automation
This skill automates Acculynx operations by discovering and executing available tools through the Rube MCP server.
by ComposioOfficial publisher
Agents not labelled yet · about 690 tokens · pinned 6 days ago
active-campaign-automation
This skill automates ActiveCampaign tasks by discovering and executing tools through Rube MCP and Composio's ActiveCampaign toolkit.
by ComposioOfficial publisher
Agents not labelled yet · about 710 tokens · pinned 6 days ago
adrapid-automation
This skill enables agents to automate Adrapid tasks through Composio's toolkit via Rube MCP.
by ComposioOfficial publisher
Agents not labelled yet · about 690 tokens · pinned 6 days ago
aeroleads-automation
This skill automates Aeroleads tasks by connecting to the Aeroleads toolkit via Composio's Rube MCP server.
by ComposioOfficial publisher
Agents not labelled yet · about 700 tokens · pinned 6 days ago
affinity-automation
This skill automates Affinity CRM operations by executing tools through Rube MCP and Composio's Affinity toolkit.
by ComposioOfficial publisher
Agents not labelled yet · about 690 tokens · pinned 6 days ago
Open roles at Writer
5 of 15 open roles on the jobs board
- Security engineer, detection and response (UK)
London, UK (Remote)
- Security engineer, application security (UK)
London, United Kingdom (Hybrid)
- Infrastructure engineer
New York City, NY, USA | Seattle, WA, USA | San Francisco, CA, USA | London, UK (Hybrid)
- Staff security engineer, application security
New York City, NY, United States | Seattle, WA, United States | San Francisco, CA, United States (Hybrid)
- AI engineer (UK)
London, UK (Hybrid)