product-marketing
Skill8 starsChanged 5 months agoMITView on GitHub
Create and maintain a product marketing context document covering positioning, ICP definition, messaging hierarchy, competitive differentiation, and value proposition. This skill creates the foundation that all other marketing skills reference. Trigger phrases: "product marketing," "positioning statement," "ideal customer profile," "ICP," "messaging hierarchy," "value proposition," "competitive differentiation," "product narrative," "use case mapping," "update our positioning," "what makes us different," "who is our customer," "messaging framework," "category design," "go to market strategy," "product story."
We split this skill into the rules it gives an agent
15 rules. 0 are common, 15 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 43 edited versions we read keep these.
15
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Every output from this skill follows these standards without exception.
- Distinctive: line 14
Write in a way that sounds like a knowledgeable human wrote it.
- Distinctive: line 15
Use short sentences. One idea per sentence.
- Distinctive: line 16
Use active voice. Never passive constructions.
- Distinctive: line 18
Use bullet points only when they genuinely improve readability.
- Distinctive: line 21
No hashtags, emojis, or asterisks.
- Distinctive: line 22
No introductory or closing filler phrases such as "in conclusion," "in summary," or "in a world where."
- Distinctive: line 23
No warnings, notes, or disclaimers.
- Distinctive: line 24
No AI cliches: no "game-changer," "unlock," "leverage," "dive into," "delve," "cutting-edge," "transformative," "revolutionize."
- Distinctive: line 25
No excessive adjectives or adverbs.
- Distinctive: line 26
No broad generalizations. Every claim tied to specific context.
- Distinctive: line 27
Use specific examples, data, and scenarios.
- Distinctive: line 150
Start with your primary message.
- Distinctive: line 176
Keep competitive differentiation updated.
- Distinctive: line 196
Use case mapping documents the specific jobs-to-be-done that your customers use your product for.
“Common” is measured: kept by at least 6 in 10 of the 43 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Product Marketing
Mandatory Content Standards
Every output from this skill follows these standards without exception.
- Match the output length to the task. For full audits, strategies, plans, or multi-part deliverables, write 1,500 to 10,000 words. For quick tasks, single assets, snippets, or narrow revisions, keep the output concise and provide only the useful variations, rationale, and next steps.
- Write in a way that sounds like a knowledgeable human wrote it. No robotic or templated phrasing.
- Use short sentences. One idea per sentence. One focus per paragraph.
- Use active voice. Never passive constructions.
- Address the reader directly using "you" and "your."
- Use bullet points only when they genuinely improve readability.
- Replace all em dashes with commas, parentheses, semicolons, or a new sentence. No hidden Unicode characters.
- End every sentence with a period.
- No hashtags, emojis, or asterisks.
- No introductory or closing filler phrases such as "in conclusion," "in summary," or "in a world where."
- No warnings, notes, or disclaimers. Stick to requested output.
- No AI cliches: no "game-changer," "unlock," "leverage," "dive into," "delve," "cutting-edge," "transformative," "revolutionize."
- No excessive adjectives or adverbs. Let specifics do the work.
- No broad generalizations. Every claim tied to specific context.
- Use specific examples, data, and scenarios.
- Pose at least one thought-provoking question per skill.
- Mobile-friendly: short paragraphs, clear headers, scannable.
- Practical and actionable. Every section connects to a next step.
What This Skill Does
This skill helps you build and maintain a product marketing context document. This document is the foundation every other piece of marketing output should draw from. It defines who your customer is, what your product does for them specifically, how you are different from alternatives, and how you talk about all of this.
Without a shared product marketing foundation, every marketing surface becomes inconsistent. Your ads say something different from your website. Your sales deck uses different language than your onboarding emails. Your team writes copy from memory rather than from strategy.
This skill produces a living document, not a one-time deliverable. Products change. Markets shift. Customer language evolves. The product marketing context document needs to be reviewed quarterly and updated whenever a significant product change, customer shift, or competitive development occurs.
The central question this document must answer: why should a specific person, in a specific situation, choose your product over every alternative available to them right now?
How to Use This Skill
To build a product marketing context document from scratch, provide:
- Your product name and a description of what it does.
- The types of customers currently using your product (company size, industry, roles).
- The three or four outcomes your customers most frequently achieve with your product.
- Your main competitors and what customers say when they choose between you.
- Any existing positioning, messaging, or ICP documents you already have.
- Specific marketing surfaces this context needs to inform (ads, website, emails, sales decks, in-app copy).
To update an existing document, provide:
- The current version of the document.
- What has changed: new features, new customer segments, new competitors, new pricing.
- Which sections feel most out of date or misaligned with how the market is actually responding.
The Product Marketing Context Document Structure
A complete product marketing context document has eight components. Each one builds on the previous.
1. Product Summary
A plain-language summary of what your product does, who it is for, and what it helps people accomplish. Two to four sentences.
This is not your tagline. It is not your elevator pitch. It is an internal document designed for clarity, not beauty. It should be specific enough that someone reading it could explain your product to a stranger accurately.
Bad product summary: "We help teams work better together."
Good product summary: "We build project management software for software development teams who ship weekly. The product replaces status meetings by making work visible in real time. Teams using it report shipping 30% faster and spending 40% less time in meetings."
The specificity in the good example is what makes it useful as a foundation. Every claim is grounded in a specific customer type, a specific outcome, and specific numbers.
2. Ideal Customer Profile (ICP)
Your ICP defines the specific type of customer that gets the most value from your product, is most likely to buy, and is most likely to retain.
The ICP is not every company that could theoretically use your product. It is the company profile where your product fits best, the value is clearest, and the sales cycle is most efficient.
A complete ICP includes:
Company characteristics:
- Industry (be specific: not "B2B" but "SaaS companies with 50-500 employees").
- Company size by headcount and revenue.
- Stage of growth (early-stage startup versus established SMB versus enterprise).
- Geographic market, if relevant.
Buyer characteristics:
- Job title or function of the decision-maker.
- Their primary goal or KPI (what they are measured on).
- Their primary frustration with the current alternative.
- Their typical buying process (who else is involved, how long it takes).
Situational triggers:
- What event or circumstance makes a company enter the market for your product? (Rapid team growth, failed implementation of a competitor, reaching a scale milestone, hiring a new person with experience using your product.)
- What does their current state look like before they buy? What are they doing with spreadsheets, manual processes, or incumbent tools?
Anti-ICP:
- Define who is NOT a good fit. This is as important as defining who is. If your product requires active collaboration between teams and a company's culture is entirely siloed, they will not get value from your product and will churn. Knowing this upfront helps you qualify out of the wrong deals.
The ICP is calibrated from data, not intuition. Look at your top 20 customers by retention, NPS, and expansion revenue. What do they have in common? What does the profile of customers who churn early look like? The difference between those two groups is your ICP.
3. Positioning Statement
A positioning statement is an internal sentence or paragraph that defines where your product sits in the market. It is written for your team, not for customers. It answers the question: what is your product, for whom, and how is it different from alternatives?
The classic format (Geoffrey Moore, "Crossing the Chasm"):
For [target customer] who [has this problem], [Product Name] is a [category] that [key benefit]. Unlike [alternative], we [key differentiator].
Example: "For marketing teams at B2B SaaS companies who need to ship more content without adding headcount, ContentCo is a content operations platform that makes it possible for one writer to manage the output of three. Unlike project management tools, ContentCo is built specifically around content workflows, with editorial calendars, brief templates, and performance tracking that marketing leaders can use without involving their ops team."
A well-written positioning statement does three things: it names the customer specifically, it names the problem specifically, and it names the differentiator against a specific alternative. Vague positioning statements name none of these specifically.
4. Value Proposition
Your value proposition describes the concrete value your product delivers. It is not a tagline. It is not a mission statement. It is the answer to "what will I get if I use this?"
A value proposition has three levels:
Functional value: what the product does. "Automates the manual work of building monthly reports."
Outcome value: what the customer achieves. "Your team closes the month in 2 days instead of 5."
Strategic value: why this matters at a business level. "You can scale revenue operations without scaling headcount."
Most marketing focuses only on functional value. The strongest value propositions articulate all three levels and lead with outcome or strategic value, not features.
Write your value proposition for each primary use case and customer role. A CFO and a marketing analyst will respond to different framings of the same product's value. The CFO cares about strategic value (cost reduction, scalability). The analyst cares about functional value (the specific time it saves them on specific tasks).
5. Messaging Hierarchy
The messaging hierarchy organizes your key messages in order of priority. It defines:
Your primary message: the single most important thing you want a customer to understand about your product. This is your headline message. It should be compelling enough to earn the next five seconds of attention.
Your secondary messages (three to five): the supporting points that explain and validate your primary message. These map to the main objections and questions a buyer has after hearing your primary message.
Your tertiary messages (by audience segment): messages tailored to specific buyer roles, use cases, or stages of the funnel.
How to build the hierarchy:
Start with your primary message. This is often your most important differentiator, stated as a customer outcome. "Ship reports in hours, not days" is a primary message. "We have an intuitive interface" is not.
Build secondary messages around the five most common objections or questions your sales team hears after explaining the product. If prospects consistently ask "but can it handle our data volume?", that is a secondary message slot.
Build tertiary messages by interviewing customers in different roles and asking what they care about most. A CTO and a marketing analyst in the same company need different messages even though they are buying the same product.
The messaging hierarchy should be short enough to memorize and specific enough to act on. A 40-page messaging document that no one uses is not a messaging hierarchy. A single page with your primary and secondary messages is.
6. Competitive Differentiation
Competitive differentiation maps how your product compares to the alternatives your customers consider. "Alternatives" include direct competitors, adjacent tools, and doing nothing.
How to structure competitive differentiation:
Name each alternative explicitly. Not "other project management tools" but "Asana," "Monday.com," and "spreadsheets." Specific names are more useful for training sales teams and writing copy.
For each alternative, document:
- Why customers choose that alternative over you.
- Why customers choose you over that alternative.
- The specific customer profile that is a better fit for each.
- What you should say when a prospect mentions that alternative.
Your differentiation should be true, defensible, and meaningful to customers. "We have a better UI" is not a defensible differentiator. "We are the only tool that integrates with both Salesforce and HubSpot without a middleware layer" is a specific, verifiable claim.
Avoid the "we're better at everything" trap. No product is genuinely better than every competitor on every dimension. Acknowledging where a competitor might be a better fit (and being clear about the customer profiles where you win) builds credibility and helps your sales team have more honest conversations.
Keep competitive differentiation updated. Competitors ship features. They change prices. They enter new segments. Competitive intelligence should be a quarterly review, not a one-time project.
7. Product Narrative
The product narrative is the story of why your product exists and why it matters. It is the "long form" version of your positioning, designed to be told in sales calls, investor pitches, conference talks, and long-form content.
A strong product narrative has four elements:
The world before: what is the current state that creates the problem? Describe the environment that makes the problem exist and feel inevitable.
The problem: what specifically does your customer experience because of that environment? Use concrete, observable details. Not "teams struggle to collaborate" but "the weekly status meeting exists because no one can see what anyone else is doing."
The solution: how does your product change the situation? Describe the new state, not the features. Not "we have real-time updates" but "your team can see the status of every project without asking, which means your Monday meeting becomes optional."
The proof: evidence that the solution works. Customer outcomes, retention rates, case studies. Specific, named examples wherever possible.
The product narrative is not the same as your elevator pitch. It is a longer, richer story that earns the emotional investment of the listener by making the problem feel real before introducing the solution.
8. Use Case Mapping
Use case mapping documents the specific jobs-to-be-done that your customers use your product for. Most products have two to five primary use cases. Each use case may have a different ICP, a different primary message, and a different conversion path.
For each use case, document:
The job to be done: what is the user trying to accomplish? Not a feature description but a task-level description of the work they are doing.
The customer profile: who is the primary user for this use case? Their role, their context, their goal.
The before state: what are they using now to do this job? What is painful or limiting about the current approach?
The after state: what does their work look like after they start using your product for this job? Specific, concrete changes in their workflow.
The key message: the one sentence that speaks directly to this use case customer.
The proof: a customer example or outcome that demonstrates this use case.
Use case mapping drives your content strategy, your ad targeting, your onboarding personalization, and your sales playbooks. Each use case is a different landing page, a different ad campaign, a different email sequence. Without mapping, you default to generic messaging that speaks to no one specifically.
Keeping the Document Current
A product marketing context document decays. The product changes. Customers change. Competitors change. Here is how to keep it current.
Quarterly review: schedule a 90-minute review every quarter with the people who are closest to customers. Your product manager, head of sales, a customer success lead, and your best salesperson. Ask: what has changed about who buys us, why they buy us, and what they say about us?
Trigger updates: outside of the quarterly review, certain events should trigger immediate document updates.
A significant product launch that changes your differentiation or expands your ICP.
A major competitor move: a new feature that erodes one of your differentiators, a price change, or a new player entering the market.
A shift in your ICP: if your last 20 customers are a different profile than your first 20, your ICP needs updating.
A message that stops working: if your primary message is generating fewer responses from ads, if your sales team is struggling with a specific objection that does not appear in the document, the document is behind reality.
Version control: date every version. When you update the document, archive the previous version with a date stamp. Being able to look back at how your positioning evolved is valuable context for future decisions.
Distribution: the document only helps if people use it. Share it with everyone who writes any customer-facing content: marketing, sales, product, customer success. Put it in a shared location everyone can access. Reference it in onboarding for new hires.
Common Product Marketing Mistakes
Writing for everyone: a positioning statement that says "we help businesses of all sizes" is not positioning. It is an absence of positioning. The more specifically you define your ICP, the more effective every piece of marketing becomes.
Leading with features instead of outcomes: customers do not care about your features. They care about what your features allow them to do, accomplish, or avoid. The features are the mechanism. The outcome is what they are buying.
Copying competitor language: if your positioning uses the same words as your top competitor, you are not differentiated. You are confirming the competitor's framing and asking customers to choose based on minor distinctions. Create your own language.
Neglecting the anti-ICP: failing to define who is not a good fit leads to winning deals you should not win. Those customers churn, write negative reviews, and drain customer success resources. Being clear about your anti-ICP is a sign of confidence, not limitation.
One-time positioning: the biggest mistake is treating product marketing as a one-time project. Markets move. The document must move with them.
Separating product marketing from product: product marketing should be involved in product decisions, not handed a finished product to market. The positioning implications of a product decision are part of the decision. Teams that separate these functions ship products that are hard to market because no one thought about market fit at the product level.
Other versions48 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 48
- coreyhaines31/marketingskills★ 58ksame name
- Nexus-JPF/note-companion★ 874same name
- OpenClaudia/openclaudia-skills★ 724same name
- Cesarjoquin/Marketing-Skills★ 190same name
- LOGIN-TB/claude-skills★ 80same name
- open-fox/agents★ 55same name
- SZcalligrapher/slash-skills-subscription★ 32same name
- the-nam-shub/e5-real-skills★ 10same name
- TommyBez/skillsboard★ 10same name
- taljeon/plzdo★ 9same name
38 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use marketing-council, public-relations and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
coreyhaines31Skillmarketing-council
When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.
Also in 18 projects that use this
CesarjoquinSkillpublic-relations
When the user wants help with public relations, earned media, press coverage, journalist outreach, or media strategy (not pull requests). Also use when the user mentions 'PR,' 'public relations,' 'press,' 'press release,' 'press coverage,' 'media outreach,' 'pitch a journalist,' 'get featured,' 'media list,' 'media kit,' 'press kit,' 'newsjacking,' 'news hijack,' 'HARO,' 'Qwoted,' 'Featured,' 'Help A Reporter,' 'reporter request,' 'tech press,' 'TechCrunch,' 'earned media,' 'thought leadership placement,' 'op-ed,' 'guest article,' 'press contacts,' or 'how do I get press.' Use this for earned media work — finding journalists, pitching stories, newsjacking, and responding to press requests. For startup/SaaS/AI directory submissions, see directory-submissions. For product launches, see launch. For social-media engagement, see social. For cold-email outreach to prospects, see cold-email.
Also in 19 projects that use this
CesarjoquinSkilloffers
When the user wants to design, construct, or improve an offer — the thing they actually sell — including value framing, bonus stacking, guarantee design, scarcity/urgency, naming, and payment structure. Also use when the user mentions 'offer,' 'offer design,' 'build an offer,' 'grand slam offer,' 'irresistible offer,' 'value stack,' 'bonus stack,' 'guarantee,' 'risk reversal,' 'money-back guarantee,' 'scarcity,' 'urgency,' 'high-ticket offer,' 'productize a service,' 'naming an offer,' 'payment plan,' 'down-sell,' 'upsell offer,' or 'why isn't my offer converting.' Best for services, agencies, courses, coaching, info products, high-ticket B2B, and direct-response. If you run pure self-serve SaaS, read pricing first — tiers and packaging do more work there. For price level itself (tiers, freemium, value metric), see pricing. For the page that presents the offer, see copywriting. For the launch moment, see launch. For sales collateral, see sales-enablement.
Also in 15 projects that use this
coreyhaines31Skillmarketing-loops
When the user wants to set up a recurring, self-running marketing workflow — a repeatable loop an AI agent runs on a cadence (weekly, daily, on a trigger) rather than a one-off task. Also use when the user mentions 'marketing loop,' 'recurring marketing workflow,' 'automate my marketing,' 'marketing on autopilot,' 'weekly marketing review,' 'ad fatigue check,' 'weekly ads check,' 'content refresh loop,' 'churn watch,' 'ranking drop alert,' 'run my SEO,' 'SEO operator,' 'daily SEO agent,' 'run my outbound,' 'AI SDR,' 'reply triage,' 'always-on marketing,' 'marketing automation workflow,' or 'run this every week.' Use this to pick, adapt, and schedule an ongoing marketing loop that orchestrates the other marketing skills. For one-off marketing ideas, see marketing-ideas. For the experimentation loop specifically, see ab-testing.
Also in 10 projects that use this
In this repository76 other files it gives its agents.
- AGENTS.mdAGENTS.md
- a11y-auditSkill
- ab-testingSkill
- ad-creativeSkill
- adsSkill
- ai-image-creatorSkill
- ai-seoSkill
- analyticsSkill
- asoSkill
- brand-guidelinesSkill
- brand-reviewSkill
- brand-storytellingSkill
- business-strategySkill
- campaign-brief-generatorSkill
- churn-preventionSkill
- cold-emailSkill
- co-marketingSkill
- community-marketingSkill
- competitive-teardownSkill
- competitor-profilingSkill
- competitorsSkill
- content-humanizerSkill
- content-repurposingSkill
- content-strategySkill
- copy-editingSkill
- copywritingSkill
- croSkill
- customer-researchSkill
- customer-serviceSkill
- customer-story-builderSkill
- directory-submissionsSkill
- ecommerce-contentSkill
- ecommerce-product-opportunity-researcherSkill
- education-contentSkill
- email-marketingSkill
- emailsSkill
- env-secrets-managerSkill
- free-toolsSkill
- imageSkill
- instagram-carouselSkill
- landing-page-croSkill
- launchSkill
- lead-magnetsSkill
- linkedin-strategySkill
- local-seoSkill
- marketing-ideasSkill
- marketing-osSkill
- marketing-psychologySkill
- market-researchSkill
- onboardingSkill
- paid-ads-opsSkill
- paywallsSkill
- podcast-pipelineSkill
- popupsSkill
- pr-communicationsSkill
- pricingSkill
- programmatic-seoSkill
- prospectingSkill
- prospect-researchSkill
- referralsSkill
- The first 60 shown.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

