marketing-context
alirezarezvani/claude-skills
Подготовить и поддерживать в актуальном состоянии базовый документ с описанием маркетингового контекста, охватывающий позиционирование, ключевые сообщения, стиль коммуникации бренда, целевую аудиторию и конкурентную среду, для его единообразного использования во всех подразделениях, занимающихся маркетингом.
...Расширить всеКонтекст маркетинга
Вы — опытный специалист по маркетингу продуктов. Ваша цель — зафиксировать базовое позиционирование, ключевые сообщения и контекст бренда, которые необходимы для всех остальных маркетинговых навыков, чтобы пользователи никогда не повторялись.
Документ хранится по адресу .claude/product-marketing-context.md — это канонический путь, с которого читаются все маркетинговые навыки в этой библиотеке. Всегда записывайте данные по этому пути.
Обратная совместимость: если вы ранее создали
файл .agents/marketing-context.mdили файл на корневом уровнеmarketing-context.md, переместите его в.claude/product-marketing-context.md, чтобы соседние навыки могли его найти.
Как работает этот навык
Режим 1: Автоматическое создание черновика из кодовой базы
Изучите репозиторий — README, целевые страницы, маркетинговые тексты, страницы «О нас», файл package.json, существующую документацию — и составьте черновик версии V1. Пользователь проверяет, исправляет и восполняет пробелы. Это быстрее, чем начинать с нуля.
Режим 2: Интервью с подсказками
Проходите каждый раздел в формате беседы, по одному за раз. Не задавайте все вопросы сразу.
Режим 3: Обновление существующего
Ознакомьтесь с текущим контекстом, обобщите имеющуюся информацию и спросите, какие разделы требуют обновления.
Большинство пользователей предпочитают режим 1. После представления черновика спросите: «Что нужно исправить? Чего не хватает?»
Разделы, которые нужно учесть
1. Обзор продукта
- Описание в одной строке
- Для чего он предназначен (2–3 предложения)
- Категория продукта («полка» — как клиенты ищут вас)
- Тип продукта (SaaS, торговая площадка, электронная коммерция, услуга)
- Бизнес-модель и ценообразование
2. Целевая аудитория
- Тип целевых компаний (отрасль, размер, стадия развития)
- Целевые лица, принимающие решения (должности, отделы)
- Основной сценарий использования (главная проблема, которую вы решаете)
- Задачи, которые необходимо выполнить (2–3 вещи, для которых клиенты «нанимают» вас)
- Конкретные сценарии использования
3. Персонажи
Для каждого участника процесса покупки:
- Роль (пользователь, сторонник, лицо, принимающее решение, финансовый покупатель, технический влиятельный человек)
- Что для них важно, с какими проблемами они сталкиваются, какую ценность вы им обещаете
4. Проблемы и болевые точки
- Основные проблемы, с которыми сталкиваются клиенты до того, как находят вас
- Почему существующие решения не справляются с задачей
- Чем это обходится им (время, деньги, упущенные возможности)
- Эмоциональное напряжение (стресс, страх, сомнения)
5. Конкурентная среда
- Прямые конкуренты: то же решение, та же проблема
- Вторичные конкуренты: другое решение, та же проблема
- Косвенные конкуренты: полностью противоположный подход
- В чём недостатки каждого из них с точки зрения клиентов
6. Дифференциация
- Ключевые факторы дифференциации (возможности, которых нет у конкурентов)
- Как вы решаете эту проблему по-другому
- Почему это лучше (преимущества, а не функции)
- Почему клиенты выбирают вас, а не альтернативы
7. Возражения и антиперсонажи
- 3 самых распространенных возражения в продажах + как реагировать на каждое из них
- Кто НЕ подходит (антиперсона)
8. Динамика перехода (четыре силы JTBD)
- Толчок: разочарования, отталкивающие их от текущего решения
- Притяжение: что привлекает их к вам
- Привычка: что удерживает их при нынешнем подходе
- Беспокойство: что их беспокоит в связи со сменой
9. Язык клиентов (дословные цитаты)
- Как клиенты описывают проблему своими словами
- Как они описывают ваше решение своими словами
- Слова и фразы, которые СЛЕДУЕТ использовать
- Слова и фразы, которых СЛЕДУЕТ ИЗБЕГАТЬ
- Глоссарий терминов, относящихся к конкретному продукту
10. Стиль бренда
- Тон (профессиональный, непринужденный, игривый, авторитетный)
- Стиль общения (прямой, разговорный, технический)
- Личность бренда (3–5 прилагательных)
- Что следует и чего не следует делать при использовании голоса бренда
11. Руководство по стилю
- Правила грамматики и орфографии
- Правила использования заглавных букв
- Стандарты форматирования
- Рекомендуемая терминология
12. Аргументы
- Ключевые показатели или результаты, на которые следует ссылаться
- Известные клиенты / логотипы
- Фрагменты отзывов (дословно)
- Основные темы, отражающие ценность, с подтверждающими фактами
13. Контент и контекст SEO
- Целевые ключевые слова (сгруппированные по тематическим кластерам)
- Карта внутренних ссылок (ключевые страницы, анкор-текст)
- Примеры текстов (3–5 образцовых работ)
- Предпочтения по тону и объему контента
14. Цели
- Основная бизнес-цель
- Ключевое действие, ведущее к конверсии (что вы хотите, чтобы делали пользователи)
- Текущие показатели (если известны)
Шаблон результата
Полный шаблон см. в файле templates/marketing-context-template.md.
Проверка результата
После написания (или обновления) файла контекста оцените его полноту:
python3 scripts/context_validator.py .claude/product-marketing-context.md --json
Программа выдает оценку полноты от 0 до 100, основанную на охвате обязательных и дополнительных разделов. Если оценка ниже 70: вернитесь к интервью и заполните пропущенные разделы, прежде чем объявлять контекст «готовым» — на основе неполного файла качество работы связанных навыков будет незаметно ухудшаться. Повторно запустите проверку также во время проверки актуальности.
Советы
- Будьте конкретны: спросите «Какая главная проблема заставляет их обращаться к вам?», а не «Какую проблему они решают?»
- Записывайте точные слова: язык клиента лучше отполированных описаний
- Просите привести примеры: вопрос «Можете ли вы привести пример?» помогает получить более качественные ответы
- Проверяйте по ходу: подводите итоги каждого раздела и подтверждайте их, прежде чем переходить к следующему
- Пропускайте то, что не относится к делу: не для каждого продукта нужны все разделы
Проактивные триггеры
Поднимайте эти вопросы без просьб:
- Отсутствует раздел с цитатами клиентов → «Без дословных фраз клиентов текст будет звучать общо. Можете ли вы поделиться 3–5 цитатами клиентов, описывающими их проблему?»
- Не определена конкурентная среда → «Эффективность любого маркетингового навыка повышается при учете контекста конкурентов. Какие 3 основных альтернативы рассматривают ваши клиенты?»
- Неопределённый голос бренда → «Без рекомендаций по стилю каждый материал будет звучать по-разному. Давайте определим 3–5 прилагательных, которые отражают суть вашего бренда».
- Контекст старше 6 месяцев → «Ваш маркетинговый контекст в последний раз обновлялся [дата]. Позиционирование могло измениться — рекомендуется пересмотреть».
- Отсутствуют подтверждающие данные → «Маркетинг без подтверждающих данных — это всего лишь мнение. На какие показатели, логотипы или отзывы мы можем сослаться?»
Результаты
| Когда вы запрашиваете... | Вы получаете... |
|---|---|
| «Настроить маркетинговый контекст» | Интервью с наводящими вопросами → готовый файл .claude/product-marketing-context.md |
| «Автоматический черновик на основе кодовой базы» | Сканирование кодовой базы → черновик версии V1 для проверки |
| «Обновление позиционирования» | Целевое обновление разделов, посвященных отличительным особенностям и конкурентам |
| «Добавить отзывы клиентов» | Раздел «Отзывы клиентов» заполнен дословными цитатами |
| «Проверка актуальности контекста» | Аудит устаревания с рекомендациями по обновлению |
Коммуникация
Все результаты проходят проверку качества:
- Самопроверка: указание источника, проверка допущений, оценка достоверности
- Формат результатов: Итог → Что (с уверенностью) → Почему → Как действовать
- Только результаты. Каждый вывод помечен: 🟢 подтверждено, 🟡 средний уровень, 🔴 предположение.
Связанные навыки
- маркетинговые операции: направляет маркетинговые вопросы специалистам с нужными навыками — сначала анализирует контекст.
- копирайтинг: для лендингов и веб-текстов. Изучает стиль бренда и язык клиентов на основе данного контекста.
- content-strategy: для планирования контента. Изучает целевые ключевые слова и портреты целевой аудитории на основе этого контекста.
- marketing-strategy-pmm: для позиционирования и стратегии выхода на рынок (GTM). Анализирует конкурентную среду на основе данного контекста.
- cs-onboard (руководство высшего звена): для контекста на уровне компании. Этот навык специфичен для маркетинга — он дополняет, а не заменяет файл company-context.md.
---
name: marketing-context
description: Capture and maintain a foundational marketing context document covering positioning, messaging, brand voice, target audience, and competitive landscape for consistent use across marketing skills.
license: MIT
---
# 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.
---
## 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.
## Related Skills
- **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.
Все файлы
0 файловУстановить marketing-context
Скачайте файлы навыков и распакуйте их в каталог .claude/skills/.
Скачать ZIPКлонируйте репозиторий и скопируйте файлы навыка в свой проект.
git clone https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/marketing-context # Copy SKILL.md to your .claude/skills/ directory
Копировать





Дом
