Guide · Agent skill
How to use the Product Marketing Context agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Product Marketing Context skill (skill name: product-marketing) helps an AI agent build and maintain one shared document about your product, audience, positioning and brand voice. This guide explains what the skill does, how to install it, how to trigger it with plain requests, and what to check before trusting its output. By the end you will have a working context file that other marketing skills can read.
Product Marketing Contextcoreyhaines31/marketingskills · MIT Download the skill Quick start
- 1Download the ZIP. Get the product-marketing skill ZIP from the skill page on this site.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Ask in plain language. Start a request with something like 'set up my product marketing context' or 'who is my target audience'.
- 5Choose a starting method. Pick auto-draft from your codebase or a section-by-section interview.
- 6Review and correct the draft. Check each section against your facts, then tell the agent what to fix or add.
- 7Use the shared file. Other marketing skills read .agents/product-marketing.md, so keep it updated as the product changes.
What the skill makes the agent do
The skill makes the agent interview you, or scan your codebase, to draft a reusable document at .agents/product-marketing.md. The document covers your product, audience, competitors, differentiation, customer language, brand voice, proof points and goals.
Other marketing skills read that file, so you do not have to re-explain your product each time. The skill also keeps a versioned changelog of what changed and why.
- Auto-draft from codebase: the agent reads files such as your README, landing pages, marketing copy, package.json and existing docs, then drafts a first version for you to correct.
- Start from scratch: the agent walks through each section one at a time, asking questions and confirming accuracy before moving on.
- Learnings: a section that starts empty and fills in as work ships.
Install the skill
Download the ZIP from the skill page on this site. Then choose one of the following methods.
You can unzip it into your personal skills folder at ~/.claude/skills/, or into a project's .claude/skills/ folder to make it available only inside that project.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
Trigger the skill with natural requests
You do not need a special command. The skill's description lists phrases that should activate it, so ask in ordinary language. The source lists phrases such as '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' and 'log this learning'.
The skill is meant for the start of a new project, before you use other marketing skills.
- Set up my product marketing context for this repo.
- Who is my target audience? Help me define my ICP.
- Draft my brand voice from our best-performing emails.
- Log this learning: the pricing page change lifted sign-ups.
Work through an example session
If no context file exists, the agent offers two options: auto-draft from the codebase (recommended in the source) or start from scratch. After it presents the draft, it asks what needs correcting and what is missing.
If the file already exists, the agent summarizes what is captured, shows the current document version and recent changelog entries, and asks which sections you want to update. It then gathers information only for those sections. Each substantive save bumps the version and adds a changelog entry.
- Review every section the agent drafts; it works from what it finds in your files and your answers.
- Push for exact customer phrases. The source notes these are more valuable than polished descriptions.
Know what the skill needs and how it runs
The skill lists no requirements. It does not run scripts and does not use the network, according to its listing.
Its files are SKILL.md, references/brand-voice.md and evals/evals.json. The brand voice reference gives extraction steps and per-person voice guides for building the voice section from real copy.
- Requires: nothing listed.
- Runs scripts: no.
- Uses network: no.
- The skill is MIT licensed.
Tips for better results
Give the agent real material. Your README, landing pages and best-performing copy give it more to work from than a blank prompt.
Treat the output as a draft. The skill does not verify claims or metrics, so check every number, customer name and proof point before other skills rely on them.
- If you have an older file named product-marketing-context.md in .agents/ or .claude/, the agent offers to move it to the canonical location.
- For brand voice, build from copy that already performed rather than adjectives chosen in a meeting.
- Keep the changelog; it records what changed and why for every later skill.
What people use it for
- A founder starting a new launch who wants consistent positioning across copy tasks.
- A small marketing team that repeatedly re-explains the product to AI tools.
- A developer who wants the agent to draft marketing context from the README and landing pages.
- Capturing brand voice from your best-performing emails and posts.
- Logging learnings as work ships so the team keeps a record of what worked.
Frequently asked questions
How do I install the product-marketing agent skill?
Download the ZIP from the skill page on this site and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload it in the Claude apps under Settings → Capabilities → Skills.
Does the product-marketing skill require anything else?
The listing shows no requirements. It does not run scripts and does not use the network.
Is the product-marketing skill free?
The skill is licensed under MIT. The source does not list prices, so check the skill page for any other terms.
Where does the skill save my marketing context?
It creates a document at .agents/product-marketing.md. Other marketing skills read that file for product, audience and positioning context.
Should I use this skill for a single piece of copy?
No. The listing says setting up the context document is overhead for a one-off task, so it suits new projects where several marketing tasks will share the same context.
Can the skill verify my claims or metrics?
No. It drafts from your files and answers, which may be inaccurate or outdated, so you should check every claim and metric yourself.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are starting a marketing project and want one shared, versioned context file that other marketing skills can read, or if you keep re-explaining your product to AI tools. Skip it if you only need one piece of copy, or if you expect the agent to verify facts, since you will need to check the draft yourself.
Download the skill