Agent skill

Marketing Context

by alirezarezvani in alirezarezvani/claude-skills

Create and maintain the marketing context document that all marketing skills read before starting.

MITAuto-check passedWriting & Content

Install Marketing Context

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill marketing-context -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills marketing-context --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing-skill/skills/marketing-context .claude/skills/marketing-context && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
marketing-context
GitHub stars
28k
Used in
1 other repo
Token cost
~1.9k tokens
SKILL.md length
909 words
Files
3 (incl. scripts)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Create and maintain the marketing context document that all marketing skills read before starting.

  • Works in 12 steps: Product Overview → Target Audience → Personas → …
  • The user mentions marketing context
  • SKILL.md covers How This Skill Works, Sections to Capture, Output Template and Validate the Result, plus 5 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Marketing Context is an agent skill from alirezarezvani/claude-skills. Create and maintain the marketing context document that all marketing skills read before starting. Use when the user mentions 'marketing context,' 'brand voice,' 'set up context,' 'target audience,' 'ICP,' 'style guide,' 'who is my customer,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Run this at the start of any new project before using other marketing skills.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/context_validator.py` and `templates/marketing-context-template.md`).

It sits in Writing & Content, covering Brand voice and tone and Positioning and messaging. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • The user mentions marketing context
  • Target audience
  • Who is my customer
  • Wants to avoid repeating foundational information across marketing tasks

Example prompts

  • “marketing context,”
  • “brand voice,”
  • “set up context,”
  • “/marketing-context”

Requirements

  • Python 3

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Product Overview
  2. Target Audience
  3. Personas
  4. Problems & Pain Points
  5. Competitive Landscape
  6. Differentiation
  7. Objections & Anti-Personas
  8. Switching Dynamics (JTBD Four Forces)
  9. Customer Language (Verbatim)
  10. Brand Voice
  11. Style Guide
  12. Proof Points

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Marketing Context loads about 1.9k tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 909 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~108
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 909 words, ~1,934 tokens.

Download SKILL.mdSave it as .claude/skills/marketing-context/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
marketing-context
description
Create and maintain the marketing context document that all marketing skills read before starting. Use when the user mentions 'marketing context,' 'brand voice,' 'set up context,' 'target audience,' 'ICP,' 'style guide,' 'who is my customer,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Run this at the start of any new project before using other marketing skills.
license
MIT
metadata.version
1.0.0
metadata.author
Alireza Rezvani
metadata.category
marketing
metadata.updated
2026-03-06

Marketing Context

You are an expert product marketer. Your goal is to capture the foundational positioning, messaging, and brand context that every other marketing skill needs — so users never repeat themselves.

The document is stored at .claude/product-marketing-context.md — the canonical path every marketing skill in this library reads. Always write to this path.

Backward compatibility: if you previously created .agents/marketing-context.md or a root-level marketing-context.md, move it to .claude/product-marketing-context.md so sibling skills can find it.

How This Skill Works

Mode 1: Auto-Draft from Codebase

Study the repo — README, landing pages, marketing copy, about pages, package.json, existing docs — and draft a V1. The user reviews, corrects, and fills gaps. This is faster than starting from scratch.

Mode 2: Guided Interview

Walk through each section conversationally, one at a time. Don't dump all questions at once.

Mode 3: Update Existing

Read the current context, summarize what's captured, and ask which sections need updating.

Most users prefer Mode 1. After presenting the draft, ask: "What needs correcting? What's missing?"


Sections to Capture

1. Product Overview
  • One-line description
  • What it does (2-3 sentences)
  • Product category (the "shelf" — how customers search for you)
  • Product type (SaaS, marketplace, e-commerce, service)
  • Business model and pricing
2. Target Audience
  • Target company type (industry, size, stage)
  • Target decision-makers (roles, departments)
  • Primary use case (the main problem you solve)
  • Jobs to be done (2-3 things customers "hire" you for)
  • Specific use cases or scenarios
3. Personas

For each stakeholder involved in buying:

  • Role (User, Champion, Decision Maker, Financial Buyer, Technical Influencer)
  • What they care about, their challenge, the value you promise them
4. Problems & Pain Points
  • Core challenge customers face before finding you
  • Why current solutions fall short
  • What it costs them (time, money, opportunities)
  • Emotional tension (stress, fear, doubt)
5. Competitive Landscape
  • Direct competitors: Same solution, same problem
  • Secondary competitors: Different solution, same problem
  • Indirect competitors: Conflicting approach entirely
  • How each falls short for customers
6. Differentiation
  • Key differentiators (capabilities alternatives lack)
  • How you solve it differently
  • Why that's better (benefits, not features)
  • Why customers choose you over alternatives
7. Objections & Anti-Personas
  • Top 3 objections heard in sales + how to address each
  • Who is NOT a good fit (anti-persona)
8. Switching Dynamics (JTBD Four Forces)
  • Push: Frustrations driving them away from current solution
  • Pull: What attracts them to you
  • Habit: What keeps them stuck with current approach
  • Anxiety: What worries them about switching
9. Customer Language (Verbatim)
  • How customers describe the problem in their own words
  • How they describe your solution in their own words
  • Words and phrases TO use
  • Words and phrases to AVOID
  • Glossary of product-specific terms
10. Brand Voice
  • Tone (professional, casual, playful, authoritative)
  • Communication style (direct, conversational, technical)
  • Brand personality (3-5 adjectives)
  • Voice DO's and DON'T's
11. Style Guide
  • Grammar and mechanics rules
  • Capitalization conventions
  • Formatting standards
  • Preferred terminology
12. Proof Points
  • Key metrics or results to cite
  • Notable customers / logos
  • Testimonial snippets (verbatim)
  • Main value themes with supporting evidence
13. Content & SEO Context
  • Target keywords (organized by topic cluster)
  • Internal links map (key pages, anchor text)
  • Writing examples (3-5 exemplary pieces)
  • Content tone and length preferences
14. Goals
  • Primary business goal
  • Key conversion action (what you want people to do)
  • Current metrics (if known)

Output Template

See templates/marketing-context-template.md for the full template.


Show full SKILL.md (373 more words)Show less

Validate the Result

After writing (or updating) the context file, score its completeness:

bash
python3 scripts/context_validator.py .claude/product-marketing-context.md --json

It emits a 0-100 completeness score from required + optional section coverage. Below 70: go back to the interview and fill the missing sections before declaring the context "done" — sibling skills will silently degrade on an incomplete file. Re-run it during the freshness audit too.


Tips

  • Be specific: Ask "What's the #1 frustration that brings them to you?" not "What problem do they solve?"
  • Capture exact words: Customer language beats polished descriptions
  • Ask for examples: "Can you give me an example?" unlocks better answers
  • Validate as you go: Summarize each section and confirm before moving on
  • Skip what doesn't apply: Not every product needs all sections

Proactive Triggers

Surface these without being asked:

  • Missing customer language section → "Without verbatim customer phrases, copy will sound generic. Can you share 3-5 quotes from customers describing their problem?"
  • No competitive landscape defined → "Every marketing skill performs better with competitor context. Who are the top 3 alternatives your customers consider?"
  • Brand voice undefined → "Without voice guidelines, every skill will sound different. Let's define 3-5 adjectives that capture your brand."
  • Context older than 6 months → "Your marketing context was last updated [date]. Positioning may have shifted — review recommended."
  • No proof points → "Marketing without proof points is opinion. What metrics, logos, or testimonials can we reference?"

Output Artifacts

When you ask for...You get...
"Set up marketing context"Guided interview → complete .claude/product-marketing-context.md
"Auto-draft from codebase"Codebase scan → V1 draft for review
"Update positioning"Targeted update of differentiation + competitive sections
"Add customer quotes"Customer language section populated with verbatim phrases
"Review context freshness"Staleness audit with recommended updates

Communication

All output passes quality verification:

  • Self-verify: source attribution, assumption audit, confidence scoring
  • Output format: Bottom Line → What (with confidence) → Why → How to Act
  • Results only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed.
  • marketing-ops: Routes marketing questions to the right skill — reads this context first.
  • copywriting: For landing page and web copy. Reads brand voice + customer language from this context.
  • content-strategy: For planning what content to create. Reads target keywords + personas from this context.
  • marketing-strategy-pmm: For positioning and GTM strategy. Reads competitive landscape from this context.
  • cs-onboard (C-Suite): For company-level context. This skill is marketing-specific — complements, not replaces, company-context.md.

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in marketing-skill/skills/marketing-context of alirezarezvani/claude-skills.

  • SKILL.md
  • scripts/context_validator.py
  • templates/marketing-context-template.md

Open the folder on GitHubat commit 19392f7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alirezarezvani/claude-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Marketing Context next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Marketing Context compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marketing Context this skillalirezarezvani/claude-skills28k1 repos~1.9kAutomated safety check: PassMIT
BrandOhh-889/skyroc79513 repos~733Automated safety check: PassMIT
Adk Style GuideBrainDAO/adk-ts119—~1.8kAutomated safety check: PassMIT
Blog BrandAgriciDaniel/claude-blog2.3k1 repos~2.3kAutomated safety check: PassMIT
Afa Brandafadtc/afa-dtc-skills168—~4.3kAutomated safety check: PassCustom licence
Brand Voice Guidelinesthatrebeccarae/claude-marketing162—~1.5kAutomated safety check: PassMIT

Similar skills

  • Brand

    Ohh-889/skyroc

    Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

    795 GitHub starsUsed in 13 repos~733 tokens
    Writing & ContentAuto-check passed
  • Adk Style Guide

    BrainDAO/adk-ts

    ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts.

    119 GitHub stars~1.8k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Blog Brand

    AgriciDaniel/claude-blog

    Establish durable brand and voice context for cross-skill consumption.

    2.3k GitHub starsUsed in 1 repo~2.3k tokens
    Writing & ContentAuto-check passed
  • Afa Brand

    afadtc/afa-dtc-skills

    DTC 品牌定位与识别——定位画布、品牌声音、品牌故事、视觉识别。触发词: 品牌定位, brand positioning, 品牌声音, 品牌故事, 视觉识别, 品牌规范, 品牌升级, brand voice, brand story, visual identity, rebrand。复杂问题先经 afa。

    168 GitHub stars~4.3k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Brand Voice Guidelines

    thatrebeccarae/claude-marketing

    Develop brand voice, tone matrices, messaging frameworks, and brand book documentation.

    162 GitHub stars~1.5k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Ogilvy Copywriting

    boraoztunc/skills

    Apply David Ogilvy's advertising principles when writing or reviewing copy, headlines, product descriptions, landing pages, ads, emails, or any persuasive text.

    397 GitHub starsUsed in 1 repo~2.7k tokens
    Writing & ContentAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Marketing Context

What does Marketing Context do?

Create and maintain the marketing context document that all marketing skills read before starting. Marketing Context is an agent skill from alirezarezvani/claude-skills. Create and maintain the marketing context document that all marketing skills read before starting.

When should I use Marketing Context?

Marketing Context fits situations like: the user mentions marketing context; target audience; who is my customer; wants to avoid repeating foundational information across marketing tasks.

How do I install Marketing Context in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill marketing-context -a claude-code`. Or copy the skill folder (marketing-skill/skills/marketing-context in alirezarezvani/claude-skills) into .claude/skills/marketing-context in your project. Claude Code loads it when a task matches its description.

How do I install Marketing Context in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill marketing-context -a codex`. Or copy the skill folder (marketing-skill/skills/marketing-context in alirezarezvani/claude-skills) into .agents/skills/marketing-context in your project. Codex loads it when a task matches its description.

Can I use Marketing Context in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill marketing-context -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/marketing-context, .gemini/skills/marketing-context, .github/skills/marketing-context and .opencode/skills/marketing-context in your project.

What does Marketing Context need to run?

Going by SKILL.md and its folder, Marketing Context needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Marketing Context access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Marketing Context safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Marketing Context use?

Marketing Context is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Marketing Context use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Marketing Context?

Skills that share tags, products or a category with Marketing Context: Brand (Ohh-889/skyroc, 795 stars), Adk Style Guide (BrainDAO/adk-ts, 119 stars), Blog Brand (AgriciDaniel/claude-blog, 2.3k stars) and Afa Brand (afadtc/afa-dtc-skills, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marketing Context?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,891 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.