code-ai-installer 1.5.5 → 2.0.1

package/domains/content/.agents/skills/cta-optimization/SKILL.md

@@ -0,0 +1,252 @@
+---
+name: cta-optimization
+description: Оптимизация CTA — воронка, психологические триггеры, формулы, платформенная адаптация, A/B варианты, метрики
+---
+# CTA Optimization — Оптимизация CTA
+
+## Когда использовать
+- При **создании контента** — формулировка CTA для поста, email, лендинга, статьи, видео.
+- При **оптимизации существующего** — CTA не конвертирует, нужна переработка.
+- При **A/B тестировании** — генерация вариантов для сравнения.
+- Как **часть `$content-brief`** — секция CTA формулируется с помощью этого скила.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Целевое действие | ✅ | Что должен сделать пользователь (одно конкретное действие) |
+| Персона ЦА | ✅ | Из `$audience-analysis` — для кого пишем CTA |
+| Этап воронки | ✅ | TOFU / MOFU / BOFU — определяет тип CTA |
+| Платформа | ✅ | Где будет размещён CTA (влияет на формат и размещение) |
+| Контекст контента | ✅ | О чём текст/пост — CTA должен логически вытекать из контента |
+| Тип контента | ⬚ | Пост / email / лендинг / статья / видео / сторис |
+| Текущий CTA | ⬚ | Если оптимизация существующего — текущая формулировка и её метрики |
+| Ограничения | ⬚ | Юридические, бренд-стоп-лист, платформенные лимиты |
+
+> Если этап воронки не указан — **определить** по контексту контента или запросить у пользователя. CTA без воронки = CTA наугад.
+
+## CTA по этапам воронки
+
+| Этап | Цель CTA | Типы действий | Примеры |
+|------|----------|---------------|---------|
+| **TOFU** (Awareness) | Привлечь, заинтересовать, подписать | Подписаться, сохранить, поделиться, узнать больше | «Подпишись, чтобы не пропустить», «Сохрани на потом» |
+| **MOFU** (Consideration) | Углубить доверие, получить контакт | Скачать, зарегистрироваться, посмотреть демо, записаться | «Скачай бесплатный гайд», «Смотри полный разбор» |
+| **BOFU** (Decision) | Конвертировать в клиента | Купить, оформить, попробовать бесплатно, забронировать | «Попробуй 14 дней бесплатно», «Забронируй место» |
+
+> **Правило:** CTA должен соответствовать этапу. TOFU + «Купи сейчас» = конфликт. BOFU + «Подпишись» = упущенная конверсия.
+
+## Психологические триггеры
+
+| Триггер | Описание | Когда использовать | Пример |
+|---------|----------|-------------------|--------|
+| **Value** | Явная выгода от действия | Всегда — базовый триггер | «Получи чеклист из 50 пунктов» |
+| **Urgency** | Ограничение по времени | Запуски, промо, события | «До пятницы — бесплатно» |
+| **Scarcity** | Ограничение по количеству | Лимитированные офферы | «Осталось 12 мест» |
+| **Social proof** | Другие уже сделали это | Подписки, покупки, регистрации | «Присоединяйся к 10 000+ подписчиков» |
+| **Loss aversion** | Страх упустить / потерять | MOFU/BOFU, высокая конкуренция | «Не упусти возможность» |
+| **Curiosity gap** | Незавершённость, интрига | TOFU, вовлекающий контент | «Узнай, какой из 5 способов работает лучше» |
+| **Reciprocity** | Отдаём ценность бесплатно → просим действие | Лид-магниты, freemium | «Скачай бесплатно — мы уже собрали всё за тебя» |
+| **Identity** | Связь с самоидентификацией | Ниши с сильным комьюнити | «Для тех, кто строит бизнес серьёзно» |
+
+> Комбинируй 1-2 триггера. Больше 2 — перегруз, CTA звучит манипулятивно.
+
+## Формулы CTA
+
+### Формула 1: Глагол + Результат
+```
+[Действие] + [что получит пользователь]
+→ «Скачай гайд по email-маркетингу»
+→ «Получи персональный план»
+```
+
+### Формула 2: Ценность → Действие
+```
+[Что пользователь получит] → [минимальное действие]
+→ «50 идей для контента — скачай бесплатно»
+→ «Готовый шаблон — забери в один клик»
+```
+
+### Формула 3: Действие + Urgency/Scarcity
+```
+[Действие] + [ограничение]
+→ «Забронируй место — осталось 5»
+→ «Попробуй бесплатно до конца недели»
+```
+
+### Формула 4: Social Proof + Действие
+```
+[Доказательство] + [действие]
+→ «10 000 маркетологов уже используют — попробуй и ты»
+→ «Присоединяйся к 500+ студентам курса»
+```
+
+### Формула 5: Вопрос + Ответ-действие
+```
+[Вопрос к боли] → [действие как решение]
+→ «Устал планировать контент вручную? Попробуй [продукт]»
+→ «Не знаешь, с чего начать? Скачай roadmap»
+```
+
+### Формула 6: Identity + Действие
+```
+[Кто ты] → [действие для таких как ты]
+→ «Для фаундеров, которые ценят время — автоматизируй»
+→ «Если ты серьёзно про рост — подпишись»
+```
+
+## Платформенная адаптация
+
+| Платформа | Формат CTA | Размещение | Ограничения | Особенности |
+|-----------|-----------|------------|-------------|-------------|
+| **Instagram (пост)** | Текст в caption | Конец caption (после ценности) | Нет кликабельных ссылок в caption | «Ссылка в bio», стрелка ↑ к bio |
+| **Instagram (сторис)** | Стикер-ссылка, свайп | Последний слайд или поверх визуала | Стикер ограничен по размеру | Крупный текст + стрелка к стикеру |
+| **Telegram** | Текст + inline-кнопка / ссылка | Конец поста | Markdown-ссылки, inline-кнопки бота | Кнопки работают лучше текстовых ссылок |
+| **Email** | Кнопка (основной) + текстовая ссылка (резервный) | Above the fold + повтор в конце | Кнопка ≤ 4-5 слов, контрастный цвет | Один основной CTA, кнопка > ссылки по CTR |
+| **Лендинг** | Кнопка (hero) + повтор по странице | Hero section + после каждого блока ценности + финал | Кнопка ≤ 5 слов | Цвет кнопки контрастен к фону, повторять 3-5 раз |
+| **YouTube** | Голосовой + текст в описании + карточки | Голос: в начале (тизер) + в конце. Описание: первые 2 строки | Первые 2 строки описания видны без «ещё» | «Ссылка в описании», end screen |
+| **LinkedIn** | Текст в посте | Конец поста | Ссылки снижают органический охват | CTA без ссылки в посте, ссылка в первом комментарии |
+
+## Протокол
+
+### Шаг 1 — Контекст
+1. Получить входные данные: персона, воронка, платформа, цель.
+2. Определить, какие триггеры уместны для этой персоны и этапа воронки.
+3. Проверить ограничения (юридика, стоп-лист, платформа).
+
+### Шаг 2 — Генерация вариантов
+1. Выбрать **2-3 формулы** из списка выше, подходящие под контекст.
+2. Для каждой формулы — сформулировать CTA с использованием выбранных триггеров.
+3. Итого: **3-5 вариантов** CTA.
+
+### Шаг 3 — Оценка вариантов
+Для каждого варианта проверить:
+
+| Критерий | Описание |
+|----------|----------|
+| Конкретность | Понятно ли, что произойдёт после клика/действия? |
+| Ценность | Есть ли явная выгода для пользователя? |
+| Краткость | ≤ 5-7 слов для кнопки, ≤ 15 слов для текстового CTA? |
+| Соответствие воронке | CTA подходит этапу TOFU/MOFU/BOFU? |
+| Соответствие персоне | CTA говорит на языке ЦА? |
+| Соответствие платформе | Формат CTA подходит для платформы? |
+| Нет манипуляции | Не больше 2 триггеров, нет обмана? |
+
+### Шаг 4 — Размещение
+1. Определить **основное размещение** — где в контенте ставить CTA.
+2. Определить **повторное размещение** — если формат позволяет (лендинг, длинная статья, email).
+3. Зафиксировать формат: кнопка / ссылка / текст / голос / стикер.
+
+### Шаг 5 — Рекомендация
+1. Выбрать **рекомендованный вариант** с обоснованием.
+2. Предложить **вариант для A/B теста** (отличающийся по триггеру или формуле).
+3. Указать метрики для оценки эффективности.
+
+## Валидация (Quality Gate)
+
+CTA считается оптимизированным если:
+
+- [ ] Одно основное целевое действие (не два равнозначных)
+- [ ] CTA соответствует этапу воронки
+- [ ] CTA содержит явную ценность для пользователя
+- [ ] CTA конкретен и понятен (читатель знает, что произойдёт)
+- [ ] CTA ≤ 5-7 слов (кнопка) или ≤ 15 слов (текстовый)
+- [ ] Формат и размещение адаптированы под платформу
+- [ ] Использовано не больше 2 психологических триггеров
+- [ ] Есть минимум 2 варианта для A/B теста
+- [ ] Нет конфликта с юридическими ограничениями и стоп-листом бренда
+
+## Handoff
+
+| Потребитель | Как использует |
+|-------------|---------------|
+| `$content-brief` | CTA вставляется в секцию CTA брифа |
+| `$email-copywriting` | CTA для email-кампаний |
+| `$seo-copywriting` | CTA для статей и лендингов |
+| `$social-media-formats` | CTA адаптированный под формат платформы |
+| `$content-review-checklist` | Reviewer проверяет CTA по пунктам #15-17 |
+
+## Интеграция с другими скилами
+
+| Скил | Взаимодействие |
+|------|----------------|
+| `$audience-analysis` | **Источник:** персона, боли, триггеры, язык клиента |
+| `$content-brief` | **Потребитель:** CTA как часть брифа |
+| `$tone-of-voice` | **Источник:** тон CTA должен соответствовать ToV бренда |
+| `$platform-strategy` | **Источник:** платформа → формат и размещение CTA |
+| `$content-review-checklist` | Ревьюер проверяет CTA на соответствие брифу и воронке |
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Несколько равнозначных CTA | Распыление внимания → ни один не работает | Один основной CTA + максимум один вторичный |
+| CTA до ценности | Читатель ещё не мотивирован | CTA после создания ценности |
+| TOFU + «Купи сейчас» | Конфликт воронки — холодная аудитория не покупает | TOFU = подпишись/сохрани, BOFU = купи |
+| «Подробнее» / «Нажми сюда» | Нет ценности, нет конкретики | Конкретный глагол + результат |
+| 3+ триггера в одном CTA | Звучит манипулятивно, вызывает недоверие | Максимум 2 триггера |
+| Одинаковый CTA везде | Не учитывает платформу и контекст | Адаптация под платформу и формат |
+| CTA не на языке ЦА | «Оформите заявку» для зумеров | Использовать язык клиента из `$audience-analysis` |
+| Нет A/B вариантов | Невозможно оптимизировать без данных | Минимум 2 варианта для сравнения |
+
+## Шаблон вывода
+
+```
+### CTA Optimization — [Контент / Кампания]
+
+**Целевое действие:** [что должен сделать пользователь]
+**Персона:** [из $audience-analysis]
+**Этап воронки:** [TOFU / MOFU / BOFU]
+**Платформа:** [платформа]
+**Тип контента:** [пост / email / лендинг / статья / видео]
+
+---
+
+#### Анализ контекста
+- **Боли персоны (релевантные):** [из $audience-analysis]
+- **Триггеры персоны:** [что мотивирует к действию]
+- **Язык клиента:** [слова и фразы ЦА]
+- **Ограничения:** [юридика / стоп-лист / платформенные]
+
+#### Выбранные триггеры
+1. [Триггер 1] — [почему подходит]
+2. [Триггер 2] — [почему подходит]
+
+---
+
+#### Варианты CTA
+
+| # | Формула | CTA | Триггеры | Оценка |
+|---|---------|-----|----------|--------|
+| A | Глагол + Результат | «[CTA]» | [триггеры] | [сильные/слабые стороны] |
+| B | Ценность → Действие | «[CTA]» | [триггеры] | [сильные/слабые стороны] |
+| C | Social Proof + Действие | «[CTA]» | [триггеры] | [сильные/слабые стороны] |
+
+#### Рекомендация
+
+**Основной CTA:** Вариант [X] — «[CTA]»
+**Обоснование:** [почему этот вариант лучше для данной персоны, воронки и платформы]
+
+**Для A/B теста:** Вариант [Y] — «[CTA]»
+**Гипотеза:** [что проверяем — другой триггер? другая формула?]
+
+**Вторичный CTA (если нужен):** «[CTA]»
+
+---
+
+#### Размещение
+
+| Размещение | Формат | Примечание |
+|------------|--------|------------|
+| [основное — где в контенте] | [кнопка / ссылка / текст / стикер / голос] | [особенности платформы] |
+| [повторное — если применимо] | [формат] | [примечание] |
+
+#### Метрики эффективности
+
+| Метрика | Целевое значение | Как измерять |
+|---------|-----------------|-------------|
+| CTR | [%] | [инструмент / платформа] |
+| Conversion rate | [%] | [инструмент / платформа] |
+| [доп. метрика] | [значение] | [инструмент] |
+
+**→ Следующий шаг:** вставить CTA в `$content-brief` / передать Copywriter
+```

package/domains/content/.agents/skills/cta-optimization/agents/claude.json

@@ -0,0 +1,10 @@
+{
+  "name": "cta-optimization",
+  "display_name": "Оптимизация CTA",
+  "description": "Оптимизация призывов к действию для максимальной конверсии",
+  "default_prompt": "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\".",
+  "triggers": ["cta-optimization", "Оптимизация CTA", "Оптимизация призывов к действию для максимальной конверсии"],
+  "capabilities": ["cta-optimization"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/cta-optimization/agents/copilot.json

@@ -0,0 +1,10 @@
+{
+  "name": "cta-optimization",
+  "display_name": "Оптимизация CTA",
+  "description": "Оптимизация призывов к действию для максимальной конверсии",
+  "default_prompt": "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\".",
+  "triggers": ["cta-optimization", "Оптимизация CTA", "Оптимизация призывов к действию для максимальной конверсии"],
+  "capabilities": ["cta-optimization"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/cta-optimization/agents/gemini.json

@@ -0,0 +1,10 @@
+{
+  "name": "cta-optimization",
+  "display_name": "Оптимизация CTA",
+  "description": "Оптимизация призывов к действию для максимальной конверсии",
+  "default_prompt": "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\".",
+  "triggers": ["cta-optimization", "Оптимизация CTA", "Оптимизация призывов к действию для максимальной конверсии"],
+  "capabilities": ["cta-optimization"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/cta-optimization/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Оптимизация CTA"
+  short_description: "Оптимизация призывов к действию для максимальной конверсии"
+  default_prompt: "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/content/.agents/skills/cta-optimization/agents/qwen.json

@@ -0,0 +1,10 @@
+{
+  "name": "cta-optimization",
+  "display_name": "Оптимизация CTA",
+  "description": "Оптимизация призывов к действию для максимальной конверсии",
+  "default_prompt": "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\".",
+  "triggers": ["cta-optimization", "Оптимизация CTA", "Оптимизация призывов к действию для максимальной конверсии"],
+  "capabilities": ["cta-optimization"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/cta-optimization/agents/skill.yaml

@@ -0,0 +1,20 @@
+version: 1
+name: "cta-optimization"
+display_name: "Оптимизация CTA"
+description: "Оптимизация призывов к действию для максимальной конверсии"
+default_prompt: "Используй $cta-optimization, когда задача относится к навыку \"Оптимизация CTA\"."
+triggers:
+  - "cta-optimization"
+  - "Оптимизация CTA"
+  - "Оптимизация призывов к действию для максимальной конверсии"
+capabilities:
+  - "cta-optimization"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"

package/domains/content/.agents/skills/data-storytelling/SKILL.md

@@ -0,0 +1,294 @@
+---
+name: data-storytelling
+description: Превращение данных в нарративы — типы data stories, техники убедительности, визуализация по типу данных, платформенная адаптация
+---
+# Data Storytelling — Data-driven нарративы
+
+## Когда использовать
+- После **сбора фактов и статистики** (`$topic-research`, `$source-verification`) — структурировать в историю.
+- При создании **аналитического контента** — статьи, карусели, инфографика, отчёты.
+- При **обосновании позиции** — кейсы, сравнения, прогнозы.
+- Для **усиления любого контента** данными — даже 1-2 цифры делают пост убедительнее.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Данные / факты | ✅ | Цифры, статистика, результаты исследований — то, из чего строим историю |
+| Источники данных | ✅ | Откуда данные: исследование, аналитика, API, отчёт, `$source-verification` |
+| Тема / контекст | ✅ | О чём рассказываем — привязка к теме контента |
+| Персона ЦА | ✅ | Из `$audience-analysis` — определяет глубину и язык подачи |
+| Платформа | ✅ | Влияет на объём, формат визуализации, глубину |
+| Цель контента | ⬚ | Информировать / убедить / вовлечь / конвертировать |
+| Тип data story | ⬚ | Если не указан — агент определяет по характеру данных |
+
+> Если данные не предоставлены — **запросить у пользователя** или направить на `$topic-research` / `$source-verification`. Не выдумывать цифры.
+
+## Типы Data Stories
+
+| Тип | Когда использовать | Вопрос, на который отвечает | Пример |
+|-----|-------------------|----------------------------|--------|
+| **Тренд** | Данные показывают изменение во времени | «Что происходит и куда движется?» | «Рынок AI-агентов вырос на 340% за год» |
+| **Сравнение** | Есть 2+ объекта или периода | «Кто лучше / что изменилось?» | «Email vs Telegram: ROI маркетинговых каналов» |
+| **Аномалия** | Есть неожиданный факт, выброс, противоречие | «Почему это странно?» | «87% компаний используют AI, но только 12% видят ROI» |
+| **Корреляция** | Связь между двумя факторами | «Что с чем связано?» | «Компании с контент-стратегией получают 6× больше лидов» |
+| **Прогноз** | Данные позволяют экстраполировать | «Что будет дальше?» | «К 2027 году 50% контента будет генерироваться AI» |
+| **Масштаб** | Нужно показать размер явления | «Насколько это много/мало?» | «Ежедневно публикуется 7.5M постов в блогах — это 87 постов в секунду» |
+
+> Тип определяет нарративную структуру и выбор визуализации.
+
+## Нарративные структуры по типам
+
+### Тренд
+```
+Контекст (было) → Точка перелома → Тренд (данные) → Что это значит → Прогноз/CTA
+```
+
+### Сравнение
+```
+Общий контекст → Объект A (данные) → Объект B (данные) → Ключевое отличие → Вывод
+```
+
+### Аномалия
+```
+Ожидание (что все думают) → Реальность (данные) → Почему так → Инсайт → Вывод
+```
+
+### Корреляция
+```
+Наблюдение → Связь (данные A + данные B) → Причина/механизм → Что с этим делать
+```
+
+### Прогноз
+```
+Текущая ситуация (данные) → Факторы роста/падения → Прогноз → Что делать уже сейчас
+```
+
+### Масштаб
+```
+Абстрактная цифра → Масштабирование (перевод в понятное) → Почему это важно → Вывод
+```
+
+## Техники убедительности
+
+| Техника | Описание | Пример |
+|---------|----------|--------|
+| **Масштабирование** | Перевод абстрактной цифры в понятную | «$3.5 трлн — это больше ВВП Великобритании» |
+| **Сравнение** | Сопоставление с чем-то знакомым | «Это как если бы каждый третий житель Москвы...» |
+| **Антитезис** | Контраст ожидания и реальности | «Все думают, что X. На самом деле — Y» |
+| **Метафора** | Перевод данных в образ | «Email-рассылка — это рыбалка: 95% улова — это тема письма» |
+| **Персонализация** | Перевод на уровень одного человека | «В среднем маркетолог тратит 6 часов в неделю на планирование контента» |
+| **Before/After** | Показать состояние до и после | «До автоматизации: 3 дня. После: 15 минут» |
+| **Rule of Three** | Три факта запоминаются лучше | «Быстрее. Дешевле. Эффективнее.» |
+| **Вопрос-ответ** | Задать вопрос, ответить данными | «Сколько стоит один лид? $5 в Instagram vs $50 в LinkedIn» |
+
+> Использовать 1-3 техники на одну data story. Больше — перегруз.
+
+## Визуализация по типу данных
+
+| Тип данных / story | Рекомендуемая визуализация | Когда НЕ использовать |
+|--------------------|--------------------------|-----------------------|
+| **Тренд** (время) | Line chart, Area chart | Pie chart (нет временной оси) |
+| **Сравнение** (категории) | Bar chart (горизонтальный), Grouped bar | Line chart (нет непрерывности) |
+| **Пропорции** (части целого) | Pie chart (≤ 5 сегментов), Stacked bar | Pie chart с 10+ сегментами |
+| **Корреляция** (две переменные) | Scatter plot, Bubble chart | Bar chart (не показывает связь) |
+| **Масштаб** (один большой факт) | Big number + контекст, Pictogram | Сложный график (убивает эффект) |
+| **Рейтинг** (порядок) | Horizontal bar (отсортированный) | Pie chart (нет порядка) |
+| **Процесс** (этапы) | Funnel chart, Sankey diagram | Pie chart |
+| **Для соцсетей** | Карусель с 1 графиком на слайд, инфографика | Сложные dashboard'ы |
+
+> Если данных мало (1-3 цифры) — визуализация не нужна. Достаточно крупного числа в тексте.
+
+## Валидация данных (обязательная)
+
+Перед построением нарратива — проверить данные:
+
+| Критерий | Вопрос | Риск если не проверить |
+|----------|--------|----------------------|
+| **Актуальность** | Когда собраны данные? | Устаревшая статистика = ложные выводы |
+| **Источник** | Кто провёл исследование? Есть ли методология? | Ненадёжный источник = нет доверия |
+| **Выборка** | Сколько респондентов / точек данных? | Маленькая выборка = случайность |
+| **Контекст** | Данные не вырваны из контекста? | Cherry-picking = манипуляция |
+| **Причинность vs корреляция** | Связь = причина или совпадение? | Ложная каузальность = ошибочный вывод |
+| **Полнота** | Показаны ли данные «за» И «против»? | Однобокость = bias |
+
+> Если данные не проходят валидацию — не использовать. Лучше меньше цифр, но надёжных.
+
+## Платформенная адаптация
+
+| Платформа | Глубина | Количество фактов | Визуализация | Формат |
+|-----------|---------|-------------------|-------------|--------|
+| **LinkedIn** | Высокая — развёрнутый анализ | 5-10 фактов | Инфографика, карусель, скриншот графика | Длинный пост / статья |
+| **Instagram** | Средняя — 1 инсайт + 2-3 факта | 2-4 факта | Карусель (1 факт = 1 слайд), инфографика | Карусель / reel |
+| **Telegram** | Средне-высокая | 3-7 фактов | Встроенные таблицы, ссылка на полный отчёт | Пост с форматированием |
+| **Twitter/X** | Низкая — 1 крючок-факт | 1-2 факта | Скриншот графика / big number | Thread или одиночный пост |
+| **YouTube** | Высокая — визуальный нарратив | 5-15 фактов | Анимированные графики, B-roll с данными | Видео-эссе / разбор |
+| **Блог / статья** | Максимальная | 10+ фактов | Встроенные графики, таблицы, интерактив | Лонгрид |
+| **Email** | Средняя — 1 ключевой инсайт | 2-3 факта | Big number, мини-инфографика | Дайджест / рассылка |
+
+## Протокол
+
+### Шаг 0 — Сбор и валидация данных
+1. Получить входные данные: факты, источники, тема, персона, платформа.
+2. Пройти **валидацию данных** по 6 критериям.
+3. Отсеять ненадёжные данные — работать только с проверенными.
+
+### Шаг 1 — Определение типа data story
+1. Проанализировать характер данных — тренд? сравнение? аномалия?
+2. Выбрать тип (или комбинацию из 2 типов).
+3. Выбрать нарративную структуру под тип.
+
+### Шаг 2 — Центральный инсайт
+1. Из всех данных — выбрать **один центральный инсайт** (главная мысль).
+2. Сформулировать в одно предложение.
+3. Проверка: инсайт **неочевиден**? Если все и так знают — это не инсайт.
+
+### Шаг 3 — Крючок-факт
+1. Выбрать **самый сильный / неожиданный факт** из данных.
+2. Это будет заголовок, hook, первое предложение.
+3. Проверка: факт вызывает реакцию «серьёзно?!» или «не знал»?
+
+### Шаг 4 — Построение нарратива
+1. Разложить данные по нарративной структуре выбранного типа.
+2. Применить **1-3 техники убедительности**.
+3. Для каждого факта — «что это значит» (не просто цифра, а интерпретация).
+4. Финал — **вывод + CTA** (что делать с этим знанием).
+
+### Шаг 5 — Визуализация
+1. Определить, нужна ли визуализация (если 1-3 цифры — не нужна).
+2. Выбрать тип визуализации по маппингу.
+3. Описать визуализацию (для `$visual-brief` или дизайнера).
+
+### Шаг 6 — Адаптация под платформу
+1. Определить глубину и количество фактов по таблице.
+2. Адаптировать формат (лонгрид vs карусель vs thread).
+3. Адаптировать язык под персону.
+
+### Шаг 7 — Финальная проверка
+Прогнать через фильтр:
+1. История понятна **без цифр**? (цифры подтверждают, не заменяют).
+2. Цифры понятны **без контекста**? Если нет — добавить масштабирование.
+3. Инсайт **неочевиден**?
+4. Данные **не вводят в заблуждение**?
+
+## Валидация (Quality Gate)
+
+Data story считается готовой если:
+
+- [ ] Все данные прошли валидацию (6 критериев)
+- [ ] Определён тип data story
+- [ ] Центральный инсайт сформулирован (1 предложение, неочевиден)
+- [ ] Крючок-факт выбран (вызывает реакцию)
+- [ ] Нарратив выстроен по структуре выбранного типа
+- [ ] Использовано 1-3 техники убедительности
+- [ ] Каждый факт имеет интерпретацию («что это значит»)
+- [ ] Визуализация выбрана (или обоснованно не нужна)
+- [ ] Адаптировано под платформу и персону
+- [ ] Финальная проверка пройдена (4 вопроса)
+
+## Handoff
+
+| Потребитель | Как использует |
+|-------------|---------------|
+| `$content-brief` | Data story как основа для конкретной единицы контента |
+| `$social-media-formats` | Адаптация data story в формат платформы |
+| `$visual-brief` | Описание визуализации для дизайнера |
+| `$seo-copywriting` | Data story как основа для SEO-статьи |
+| `$email-copywriting` | Крючок-факт + инсайт для email |
+| Copywriter (агент) | Нарратив как каркас для текста |
+
+## Интеграция с другими скилами
+
+| Скил | Взаимодействие |
+|------|----------------|
+| `$topic-research` | **Источник:** данные и факты по теме |
+| `$source-verification` | **Источник:** верифицированные данные |
+| `$audience-analysis` | **Источник:** персона → глубина и язык подачи |
+| `$platform-strategy` | **Источник:** платформа → формат и объём |
+| `$fact-checking` | **Потребитель:** проверяет данные в финальном контенте |
+| `$visual-brief` | **Потребитель:** спецификация визуализации |
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Цифры без контекста | «Рынок $4.2 трлн» — и что? Много это или мало? | Масштабирование: «Это больше ВВП Германии» |
+| Данные вместо истории | Перечень фактов без нарратива | Сначала структура, потом данные подтверждают |
+| Cherry-picking | Показаны только удобные данные | Показать полную картину, включая «неудобные» факты |
+| Корреляция = причинность | «Мороженое → утопления» | Явно указать: корреляция, не причинность |
+| Устаревшие данные | «Исследование 2019 года» в 2026 | Данные ≤ 2 лет, для быстрых рынков ≤ 1 год |
+| Слишком много цифр | 15 фактов в одном посте | 2-5 фактов для соцсетей, больше — для лонгридов |
+| Нет инсайта | Все и так знали этот факт | Инсайт = неочевидный вывод из данных |
+| Выдуманные данные | Агент сгенерировал «статистику» | Только верифицированные источники |
+
+## Шаблон вывода
+
+```
+### Data Story — [Тема]
+
+**Тип:** [Тренд / Сравнение / Аномалия / Корреляция / Прогноз / Масштаб]
+**Персона:** [из $audience-analysis]
+**Платформа:** [платформа]
+**Источники данных:** [перечень с годами]
+
+---
+
+#### Центральный инсайт
+[Одно предложение — главный неочевидный вывод из данных]
+
+#### Крючок-факт (для заголовка / hook)
+[Самый сильный / неожиданный факт — вызывает реакцию]
+
+---
+
+#### Нарратив
+
+**Контекст:** [Почему это важно сейчас — 1-2 предложения]
+
+**[Структура по типу data story]:**
+
+| Факт | Источник | Что это значит |
+|------|----------|---------------|
+| [Факт 1 — конкретная цифра] | [источник, год] | [интерпретация для ЦА] |
+| [Факт 2 — конкретная цифра] | [источник, год] | [интерпретация для ЦА] |
+| [Факт 3 — конкретная цифра] | [источник, год] | [интерпретация для ЦА] |
+
+**Инсайт:** [Неочевидный вывод — то, что не видно в отдельных цифрах]
+
+**Вывод / CTA:** [Что с этим делать → привязка к цели контента]
+
+---
+
+#### Техники убедительности
+1. [Техника 1] — как применена: «[пример из текста]»
+2. [Техника 2] — как применена: «[пример из текста]»
+
+#### Визуализация
+
+| Элемент | Тип визуала | Данные | Формат для платформы |
+|---------|------------|--------|---------------------|
+| [что визуализируем] | [line chart / bar / big number / ...] | [какие данные] | [размер, стиль] |
+
+> N/A — если данных 1-3 и визуализация не нужна.
+
+#### Валидация данных
+
+| Критерий | Статус | Примечание |
+|----------|--------|------------|
+| Актуальность (≤ 2 лет) | ✅/❌ | [год данных] |
+| Надёжный источник | ✅/❌ | [кто провёл] |
+| Достаточная выборка | ✅/❌ | [N респондентов/точек] |
+| Не вырвано из контекста | ✅/❌ | |
+| Причинность vs корреляция | ✅/❌ | |
+| Полнота (нет cherry-picking) | ✅/❌ | |
+
+---
+
+#### Адаптация под платформу
+- **Глубина:** [высокая / средняя / низкая]
+- **Количество фактов:** [N]
+- **Формат:** [карусель / пост / thread / лонгрид / видео]
+- **Язык:** [адаптация под персону]
+
+**→ Следующий шаг:** передать в `$content-brief` / `$visual-brief` / Copywriter
+```

package/domains/content/.agents/skills/data-storytelling/agents/claude.json

@@ -0,0 +1,10 @@
+{
+  "name": "data-storytelling",
+  "display_name": "Data-сторителлинг",
+  "description": "Превращение данных в compelling нарративы для контента",
+  "default_prompt": "Используй $data-storytelling, когда задача относится к навыку \"Data-сторителлинг\".",
+  "triggers": ["data-storytelling", "Data-сторителлинг", "Превращение данных в compelling нарративы для контента"],
+  "capabilities": ["data-storytelling"],
+  "tools": [],
+  "implicit_invocation": true
+}