| name | product-marketing |
| description | Creates and maintains the product marketing context doc at /product-marketing.md — the shared source other marketing skills (copywriting, cro, seo-audit, kortix-image) read first. Use when setting up, auto-drafting, updating, or checking product/marketing context. |
Product Marketing Context
Owns one artifact: /product-marketing.md — the product/marketing source of truth other skills load before they write anything. This skill creates it, keeps it current, and reports on it. It does not write campaigns, copy, or pages itself — it feeds the skills that do.
File location
- Primary:
/product-marketing.md
Always check all three before creating a new one, so you update the existing doc instead of duplicating it.
Routing
Pick the mode from what the user asks:
| User intent | Mode |
|---|
| "set up / create product (marketing) context" | Create |
| "auto-draft from our codebase / site / materials" | Auto-draft |
| "update our context — we changed X" | Update |
| "do we have context set up? / is it there?" | Status |
| asks for actual copy, CRO, SEO, ads, images | Defer (see below) |
Casual phrasing counts — "make a product context doc for my app…" triggers this skill the same as a formal request.
Create
- Check the three locations. If a doc already exists, switch to Update instead of overwriting.
- Offer two options:
- (1) Auto-draft from codebase (recommended) — fast; fills what it can from existing materials.
- (2) Start from scratch — walk the sections together.
- If scratch: go one section at a time, conversationally — ask, confirm, move on. Never dump all the questions at once.
- Write the result to
/product-marketing.md.
Auto-draft
- Scan the repo/site for existing marketing signal:
README, landing page copy, pricing page, about page, <meta> descriptions / OG tags, docs, and any existing positioning.
- Draft each section from what you find.
- Flag every section that needs manual input — anything you couldn't source confidently — rather than inventing it.
- Present the full draft for review. Save to
/product-marketing.md only after the user approves.
Update
- Read the existing doc.
- From the change described, identify only the affected sections. Example — "new enterprise tier + VP of Engineering audience" touches: Target Audience, Personas (new persona), Product Overview (tier + its pricing), Objections (enterprise-specific), Competitive Landscape (enterprise rivals).
- Edit those sections; preserve everything else verbatim. Pricing lives inside Product Overview, not a separate section.
Status
- Check
/product-marketing.md.
- Report whether it exists and summarize its contents if found.
- If missing, offer to create it and explain the value: other skills (copywriting, cro, seo-audit, kortix-image, …) read this doc first so their output stays on-product and consistent.
Sections
Cover the applicable ones — each is a heading in the doc.
- Product Overview — what it is, category, key features, pricing/tiers.
- Target Audience — who it's for (segments, company size, roles).
- Personas — named buyer/user profiles, their jobs and pains.
- Problems You Solve — the concrete problems and the cost of the status quo.
- Competitive Landscape — alternatives and incumbents.
- Differentiation — why you, not them.
- Objections — what makes prospects hesitate, and the answers.
- Switching Dynamics — what it takes to leave the current solution (cost, friction, triggers).
- Customer Language — real words customers use, for copy that resonates.
- Brand Voice — tone and style rules.
- Proof Points — metrics, logos, testimonials, case studies.
- Goals — what marketing is trying to achieve.
Adapt to the business
Don't force all 12 sections.
- B2B vs B2C: B2C often needs lighter, less formal Personas and Switching Dynamics — skip what doesn't apply rather than padding it.
- Early-stage / pre-launch: Proof Points, Competitive Landscape, and Customer Language are often sparse. That's fine — say so and note they can be filled in as the business matures, rather than blocking on them.
- Match the questions to the model and stage (a B2B SaaS, a solo B2C mobile app, and an enterprise platform each need a different cut).
Defer for execution tasks
If the user actually wants output — homepage copy, landing pages, CRO changes, SEO, ads, images — this is not the skill that produces it. Check for /product-marketing.md (and suggest creating one if it's missing), then hand off to the skill that owns the work (e.g. the copywriting skill for homepage copy). Don't generate that output using this skill's context-creation flow.
