Equip AI agents with product marketing context and workflows

Creates and maintains a product marketing context document at .agents/product-marketing.md that captures foundational positioning and messaging so other marketing skills (pricing, onboarding, offers, open-source-marketing, and others) can reference it instead of the user repeating themselves. It first checks for an existing file at the canonical path plus two legacy locations (.claude/product-marketing.md and product-marketing-context.md in either folder), offering to migrate a found legacy file to the canonical path. If a context document already exists, it reads and summarizes it, then only asks about the sections the user wants updated. If none exists, it offers two paths: auto-drafting a V1 by studying the codebase (README, landing pages, marketing copy, meta descriptions, package.json, existing docs) for the user to correct and fill gaps in - the recommended, faster default most users pick - or a conversational walk-through of each section one at a time, pushing for verbatim customer language over polished descriptions since exact phrases reflect how customers actually think and make copy more resonant. The document covers 12 sections: product overview (one-liner, category, type, business model); target audience (company type, decision-makers, primary use case, jobs to be done); B2B personas (user, champion, decision maker, financial buyer, technical influencer, each with what they care about and the value promised); problems and pain points (core challenge, why alternatives fall short, cost, emotional tension); competitive landscape split into direct (same solution, same problem), secondary (different solution, same problem), and indirect (conflicting approach) competitors, each with why it falls short; differentiation (key differentiators, how and why it's better, why customers choose this over alternatives); objections and anti-personas (top 3 sales objections with responses, and who is explicitly not a good fit); switching dynamics via the JTBD Four Forces (push away from the current solution, pull toward this one, habit keeping them stuck, anxiety about switching); customer language (verbatim problem and solution descriptions, words to use and avoid, a glossary); brand voice (tone, communication style, 3-5 personality adjectives); proof points (metrics, customer logos, testimonial snippets, value themes with supporting evidence); and goals (primary business goal, key conversion action, current metrics). The finished document follows a fixed markdown template with a last-updated date and tables for personas, objections, glossary terms, and value themes. After the user confirms it, the skill saves it and tells them other marketing skills will now use it automatically, and that re-running this skill anytime updates it.

Use it when someone wants to create or update their product marketing context, mentions positioning, target audience, ICP, or wants to document how they describe their product and customers before other marketing work begins. It's the foundational context-gathering skill other marketing skills (pricing, onboarding, offers, open-source-marketing, and more) check for and build on - run it first, or whenever positioning or audience understanding has meaningfully changed.

Input is either the existing codebase (README, landing pages, marketing copy) for auto-drafting, or conversational answers to the 12 section prompts, ideally including verbatim customer language. Output is .agents/product-marketing.md, a structured markdown document covering positioning, audience, competition, differentiation, customer language, brand voice, proof points, and goals.

Writes to .agents/product-marketing.md, which every other marketing skill in the same family (pricing, onboarding, offers, open-source-marketing, and others) checks for and reads before asking its own context questions.

Founders and marketers who want a single, reusable source of truth for product positioning, target audience, and customer language - drafted quickly from the existing codebase - so they don't have to re-explain the same context to every other marketing skill they use.