positioning-messaging
Create a Positioning & Messaging Pack (positioning statement, messaging hierarchy, value proposition, tagline/headlines, copy set, validation plan). Use for positioning, messaging, value prop, tagline, homepage hero, one-liner, elevator pitch, and press pattern-matching.
What this skill does
# Positioning & Messaging ## Scope **Covers** - Positioning (category, ICP, differentiation, “against what alternative”) - Messaging hierarchy (core message + pillars + proof) - Value proposition + copy primitives (one-liner, tagline, headline/subhead, elevator pitch) - Channel adaptation (website, sales, press pattern-matching) - Lightweight message validation plan **When to use** - “We need clearer positioning and messaging.” - “Rewrite our value prop / one-liner / tagline / homepage hero.” - “People don’t ‘get it’—pipeline is sluggish and sales keeps re-explaining.” - “Create a messaging hierarchy and proof points for <ICP>.” - “Give me 5 headline/tagline options that fit our positioning.” **When NOT to use** - You need to decide *what to build* (use a problem definition / strategy workflow first) - You need a full brand identity system (visual identity guidelines, logo, UI kit) - You need only copyediting/tone-polish of existing copy with no positioning change - You don’t have (or refuse to assume) an ICP/use case and “alternative” to position against ## Inputs **Minimum required** - Product: what it is + what it does (1–3 sentences) - Target audience (ICP/persona) and primary use case / job-to-be-done - Primary alternative(s): status quo, competitor, internal build, agency, manual workaround - Differentiators + proof (features, results, customer quotes, credibility signals) - Primary surface(s): website hero, sales pitch, deck, ads, press, app onboarding - Constraints: tone/voice, compliance/claims, taboo words, time box **Missing-info strategy** - Ask up to 5 questions from [references/INTAKE.md](references/INTAKE.md). - If answers aren’t available, proceed with explicit assumptions and label unknowns. Provide 2–3 alternate positioning directions if uncertainty is high. ## Outputs (deliverables) Produce a **Positioning & Messaging Pack** in Markdown (in-chat; or as files if requested): 1) **Context snapshot** (decision, ICP, use case, surfaces, constraints) 2) **Positioning brief** (category + “against” alternative + differentiation + proof + tradeoffs) 3) **Messaging hierarchy** (core message + 3 pillars + proof points + objections) 4) **Copy set** (one-liner, elevator pitch, tagline options, homepage hero headline/subhead, CTA suggestions) 5) **Consistency enablement** (“say this / not that”, internal script, sales talk track) 6) **Validation plan** (how to test for understanding + recall; next iteration loop) 7) **Risks / Open questions / Next steps** (always included) Templates: [references/TEMPLATES.md](references/TEMPLATES.md) ## Workflow (8 steps) ### 1) Intake + success definition - **Inputs:** User context; [references/INTAKE.md](references/INTAKE.md). - **Actions:** Clarify ICP, use case, primary surface(s), and what “better” means (pipeline response, conversion, comprehension, recall). - **Outputs:** Context snapshot. - **Checks:** A stakeholder can answer: “Who is this for, and what will this messaging change?” ### 2) Choose the “against” alternative + category frame - **Inputs:** Known competitors/status quo; market context. - **Actions:** Identify the real alternative in the decision (status quo/workaround/competitor). Choose a category frame and a simple pattern match (“<category> for <audience>”). - **Outputs:** “Against” alternative + category statement options. - **Checks:** The category is understandable without a glossary; the “against” alternative is explicit. ### 3) Write the positioning brief (specific, with tradeoffs) - **Inputs:** Differentiators + proof. - **Actions:** Draft a positioning statement and supporting brief: value, differentiation, proof, and what you *don’t* do (tradeoffs/non-goals). - **Outputs:** Positioning brief. - **Checks:** The positioning could not plausibly fit 3 different competitors; proof is concrete or labeled “to validate”. ### 4) Build a messaging hierarchy (listener-first) - **Inputs:** Positioning brief; audience pains/goals; objections. - **Actions:** Create: core message → 3 pillars → proof points. Add “what we mean / what we don’t mean” to prevent confusion. - **Outputs:** Messaging hierarchy + proof bank. - **Checks:** A first-time reader can restate the value in one sentence; message is memorable (see checklist). ### 5) Generate copy primitives (tight + pattern-matched) - **Inputs:** Messaging hierarchy; target surfaces. - **Actions:** Draft one-liner, elevator pitch, tagline options, and hero headline/subhead. Keep it direct; use pattern matching when helpful (especially for press). - **Outputs:** Copy set (v1). - **Checks:** Copy is concrete (specific nouns/verbs), avoids vague superlatives, and matches the category frame. ### 6) Create consistency + enablement assets - **Inputs:** Copy set; internal stakeholders; sales/support needs. - **Actions:** Produce “say this / not that”, internal description script, and a short sales talk track + “reset” explanation for confused prospects. - **Outputs:** Consistency enablement section. - **Checks:** Two different team members would describe the product the same way. ### 7) Draft a validation plan (understanding + recall) - **Inputs:** Channels + time box; access to customers/prospects. - **Actions:** Propose a lightweight test plan: comprehension (“what is it?”), relevance (“is this for you?”), and recall (“what do you remember tomorrow?”). Include 5–8 test questions and a decision rule. - **Outputs:** Validation plan + iteration loop. - **Checks:** Plan is feasible given constraints; includes a clear “revise/keep” rule. ### 8) Quality gate + finalize - **Inputs:** Draft pack. - **Actions:** Run [references/CHECKLISTS.md](references/CHECKLISTS.md) and score with [references/RUBRIC.md](references/RUBRIC.md). Add Risks/Open questions/Next steps. - **Outputs:** Final Positioning & Messaging Pack. - **Checks:** The pack is usable as-is by marketing + sales + founders; assumptions are explicit. ## Quality gate (required) - Use [references/CHECKLISTS.md](references/CHECKLISTS.md) and [references/RUBRIC.md](references/RUBRIC.md). - Always include: **Risks**, **Open questions**, **Next steps**. ## Examples **Example 1 (B2B SaaS):** “We’re an AI QA tool for customer support teams. Create positioning + messaging and 5 homepage hero options.” Expected: positioning brief (against ‘manual QA + spreadsheets’), messaging pillars with proof, one-liner/taglines, hero headline/subhead set, and validation questions. **Example 2 (Marketplace):** “We’re moving upmarket. Reposition for IT managers and draft an elevator pitch + sales talk track.” Expected: revised category frame and “against” alternative, updated messaging hierarchy for the new buyer, pitch + talk track, and a short enablement section. **Boundary example:** “Write me a logo and brand identity.” Response: decline visual identity work; offer to produce positioning/messaging and a brief for a brand designer.
Related in Writing & Docs
jax-development
IncludedUse this skill when the user is writing, debugging, profiling, refactoring, reviewing, benchmarking, parallelising, exporting, or explaining JAX code, or when they mention JAX, jax.numpy, jit, grad, value_and_grad, vmap, scan, lax, random keys, pytrees, jax.Array, sharding, Mesh, PartitionSpec, NamedSharding, pmap, shard_map, Pallas, XLA, StableHLO, checkify, profiler, or the JAX repo. It helps turn NumPy or PyTorch-style code into pure functional JAX, fix tracer/control-flow/shape/PRNG bugs, remove recompiles and host-device syncs, choose transforms and sharding strategies, inspect jaxpr/lowering/IR, and benchmark compiled code correctly.
nature-article-writer
IncludedDrafts, rewrites, diagnostically critiques, and style-calibrates primary research manuscripts for Nature and Nature Portfolio journals. Use when the user wants a Nature-style title, summary paragraph or abstract, introduction, results, discussion, methods, figure legends, presubmission enquiry, cover letter, reviewer response, or when a scientific draft sounds generic, jargon-heavy, structurally weak, or AI-ish and needs precise, broad-reader-friendly prose without inventing data, analyses, or references. Best for primary research articles and letters rather than reviews or press releases unless explicitly adapting one.
deckrd
IncludedDocument-driven framework that derives requirements, specifications, implementation plans, and executable tasks from goals through structured AI dialogue. Use when user says "write requirements", "create spec", "plan implementation", "derive tasks", "structure this feature", "break down into tasks", or "document this module". Also use for reverse engineering existing code into docs (/deckrd rev). Do NOT use for direct code writing — use /deckrd-coder after tasks are generated. Do NOT use when the user only wants to run or fix existing code without planning.
clinical-decision-support
IncludedGenerate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
handling-sf-data
IncludedSalesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data factory patterns for Apex tests, or needs to seed/clean records in a Salesforce org. DO NOT TRIGGER when: SOQL query writing only (use querying-soql), Apex test execution (use running-apex-tests), or metadata deployment (use deploying-metadata).
accelint-ac-to-playwright
IncludedConvert and validate acceptance criteria for Playwright test automation. Use when user asks to (1) review/evaluate/check if AC are ready for automation, (2) assess if AC can be converted as-is, (3) validate AC quality for Playwright, (4) turn AC into tests, (5) generate tests from acceptance criteria, (6) convert .md bullets or .feature Gherkin files to Playwright specs, (7) create test automation from requirements. Handles both bullet-style markdown and Gherkin syntax with JSON test plan generation and validation.