product-marketing Skill for Claude Code: Build Your Marketing Context File

Writes a product marketing context file with your positioning, audience and brand voice that the other marketing skills read first.

Installs: 88.7K; on skills.sh
Stars: 57.9K; on GitHub
Files: 2; besides SKILL.md
Updated: Oct 2026; last repo commit

product-marketing makes your assistant write a product marketing context document at .agents/product-marketing.md. If no file exists it offers two routes: draft it from your codebase (README, landing pages, marketing copy, package.json) and ask you to correct it, or interview you section by section. If a file exists it summarizes it and asks which sections to update.

The document has 14 sections, from product overview and target audience to customer language, brand voice, proof points, goals, an optional paid ads section and a Learnings log. Each substantive save bumps a version number and adds a Changelog line. It triggers on prompts about positioning, ICP, brand voice or 'set up context'. It bundles a brand-voice reference and an evals/evals.json file, and no scripts.

Good for

Founders who retype their product pitch into every prompt
Developers who need marketing context drafted from their repo
Marketers who want one source of truth for positioning and voice

Install product-marketing

Claude Code

Copy this prompt.

Install the product-marketing skill in Claude Code. Run this command:

npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' 'brand voice,' 'tone of voice,' 'brand guidelines,' 'what have we learned,' 'log this learning,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing skills — it creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context.

Sections in SKILL.md

Workflow
Step 1: Check for Existing Context
Step 2: Gather Information
Sections to Capture
1. Product Overview
2. Target Audience
3. Personas (B2B only)
4. Problems & Pain Points
5. Competitive Landscape
6. Differentiation
7. Objections & Anti-Personas
8. Switching Dynamics
9. Customer Language
10. Brand Voice
11. Proof Points
12. Goals

Key facts

Author: Corey Haines
Repo: coreyhaines31/marketingskills
Installs on skills.sh: 88,670 (Nov 2, 2026)
GitHub stars (whole repo): 57,855 (Nov 2, 2026)
License: MIT
Last repo commit: Oct 31, 2026
Files in the skill folder: 3 files: SKILL.md, evals/evals.json, references/brand-voice.md
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Saves to: .agents/product-marketing.md in your project
Sections in the file: 14, from Product Overview to Learnings

What it includes

Looks for .agents/product-marketing.md, .claude/product-marketing.md or the old name
Files · 1. Check for existing context
Auto-drafts from your codebase or walks you through each section by conversation
Files · 2. Gather information
Writes the 14-section context file with a version and a Changelog
Write · 3. Create the document
Bumps the version and adds a Changelog entry on every substantive change
Write · 4. Confirm, version and save
Logs which angles and offers worked, so drafting skills read them before writing
Write · Maintaining Learnings

From the official docs

Questions

What does the product-marketing skill do?

It builds a context file that holds your product overview, audience, competitors, differentiation, customer language and brand voice. Other marketing skills read it so you do not repeat yourself.

How do I install the product-marketing skill?

Use the install box at the top of this page. The repo's README also offers a Claude Code plugin called marketing-skills that installs every skill in the collection, and a Codex plugin route for the same set. Pick one skill only if you want just this one. If you ask an agent session to run npx skills for you, the README says to pass -a claude-code, because the CLI may otherwise install only to .agents/skills/, which Claude Code does not read.

Where does it save the file?

In .agents/product-marketing.md. It also checks .claude/product-marketing.md and the legacy product-marketing-context.md name, and offers to move an older file to the canonical path.

Which skills read this file?

The README says every other skill in the collection checks it first. The SKILL.md adds that the ads skill reads the Paid Ads section, and that copywriting, emails, ads, ad-creative and social read the Learnings log before writing.

Should I let it draft from my codebase?

The SKILL.md recommends it and says most users prefer it. It reads files such as your README, landing pages and marketing copy, then asks what needs correcting.

Is the product-marketing skill safe to install?

It is a markdown skill. The folder bundles reference files and an evals/evals.json file, and no scripts. The SKILL.md names no API key. It changes how your assistant works in your project, so read the SKILL.md if you need to review it first. The skill writes one markdown file in your project, so check it before you commit it if it holds positioning you want to keep private.

Information

updated Nov 2, 2026

Repository: coreyhaines31/marketingskills
Folder: skills/product-marketing

coreyhaines31/marketingskills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

marketingskills README · github.com
product-marketing SKILL.md · github.com
product-marketing on skills.sh · skills.sh