code-ai-installer 1.5.6 → 2.0.1

package/domains/content/.agents/skills/social-media-formats/SKILL.md

@@ -0,0 +1,466 @@
+---
+name: social-media-formats
+description: Форматы соцсетей — 7 платформ, форматные шаблоны (карусель, thread, reel), engagement-приёмы, адаптация ToV, алгоритмические best practices
+---
+# Social Media Formats — Форматы соцсетей
+
+## Когда использовать
+- При **адаптации контента** из `$content-brief` под конкретную платформу.
+- При **кросс-постинге** — адаптация одного контента под несколько платформ.
+- При **создании platform-native контента** — контент изначально под одну платформу.
+- При **выборе формата** — пост vs карусель vs reel vs thread — что лучше для данной задачи.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Контент-бриф | ✅ | Из `$content-brief` — тема, тезисы, CTA, персона |
+| Платформа | ✅ | Куда адаптируем |
+| Формат | ✅ | Пост / карусель / reel / stories / thread / видео (или агент рекомендует) |
+| Персона ЦА | ✅ | Из `$audience-analysis` — влияет на тон и язык |
+| Бренд-гайдлайны | ✅ | Из `$brand-guidelines` — ToV, визуальный стиль |
+| Текст-исходник | ⬚ | Если адаптация существующего текста (из блога, email, другой платформы) |
+
+> Если формат не указан — агент **рекомендует** оптимальный формат для задачи и платформы.
+
+## Выбор формата — Decision Tree
+
+| Контент | Instagram | TikTok | LinkedIn | Telegram | YouTube | Twitter/X |
+|---------|-----------|--------|----------|----------|---------|-----------|
+| Образовательный (how-to) | Карусель / Reel | Видео | Пост / Carousel PDF | Пост | Видео / Shorts | Thread |
+| Listicle (N пунктов) | Карусель | Photo Carousel | Carousel PDF | Пост с буллетами | — | Thread |
+| Кейс / история | Reel / Пост | Видео (storytelling) | Длинный пост | Пост | Видео | Thread |
+| Новость / инсайт | Пост / Stories | — | Пост | Пост | Community post | Твит |
+| Развлечение / тренд | Reel | Видео | — | — | Shorts | Твит с мемом |
+| Данные / статистика | Карусель / Инфографика | — | Пост + инфографика | Пост + картинка | — | Твит + скриншот |
+| Опрос / вовлечение | Stories Poll | — | Poll | Quiz-бот / реакции | Community Poll | Poll |
+
+## Платформы — форматы, лимиты, структуры
+
+### Instagram
+
+#### Форматы
+
+| Формат | Лимит | Видимость до «ещё» | Визуал | Best for |
+|--------|-------|--------------------|---------|----|
+| **Feed пост** | 2200 символов | Первые 125 символов | 1 фото/видео | Новости, инсайты, short stories |
+| **Карусель** | 2200 символов caption | Первые 125 символов | 2-10 слайдов | Образовательный, listicle, how-to |
+| **Reel** | 2200 символов | Первые 125 символов | Видео 9:16, 15-90 сек | Тренды, how-to, behind the scenes |
+| **Stories** | — | — | Фото/видео 9:16, 15 сек | Быстрые обновления, polls, ссылки |
+
+#### Структура поста
+```
+[Hook — первые 125 символов, до «ещё». Захватить внимание.]
+
+[Развитие — ценность, тезисы, история. 3-5 коротких абзацев.]
+
+[CTA — одно действие: сохрани / подпишись / напиши в комменты]
+
+·
+·
+·
+
+#хэштег1 #хэштег2 #хэштег3 (3-5 штук, после пустых строк)
+```
+
+#### Шаблон карусели (10 слайдов)
+```
+Слайд 1: ОБЛОЖКА — Hook-заголовок (крупный текст, визуальный крючок)
+Слайд 2: Проблема / Контекст (почему это важно)
+Слайд 3-8: Тезисы (1 тезис = 1 слайд, крупный текст + мини-пояснение)
+Слайд 9: Итог / Резюме
+Слайд 10: CTA — «Сохрани», «Подпишись», «Поделись»
+```
+
+#### Engagement-приёмы
+- **Сохрани** — карусели и чеклисты → saves (сильный сигнал алгоритму)
+- **Напиши [слово] в комменты** — но не engagement bait (вопрос должен быть искренним)
+- **Опрос в Stories** — 2-3 варианта, простой вопрос
+- **Подпись → дискуссия** — закончить пост вопросом к аудитории
+
+#### Алгоритмические best practices
+- 🟢 Saves и Shares весят больше лайков
+- 🟢 Reels с hook в первые 3 секунды
+- 🟢 Карусели удерживают внимание (swipe = engagement)
+- 🔴 Engagement bait penalty: «Лайкни если согласен»
+- 🔴 Водяной знак TikTok → снижение охвата
+- 🔴 Частые правки после публикации → сброс буста
+
+---
+
+### TikTok
+
+#### Форматы
+
+| Формат | Лимит | Визуал | Best for |
+|--------|-------|--------|----|
+| **Видео** | 2200 символов caption | 9:16, 15 сек — 10 мин | Тренды, how-to, storytelling, юмор |
+| **Photo Carousel** | 2200 символов | 9:16, ≤ 35 фото | Listicle, образовательный |
+
+#### Структура видео
+```
+0-3 сек: HOOK — захват внимания (текст на экране + голос)
+3-15 сек: Контекст — почему это важно
+15-45 сек: Ценность — тезисы, шаги, история
+Последние 3-5 сек: CTA — подпишись / смотри часть 2 / ответь в комментах
+```
+
+#### Engagement-приёмы
+- **Ответ на комментарий** (видео-ответ) — генерирует engagement + новый контент
+- **Дуэт / Стич** — реакция на чужой контент
+- **Серия** — «Часть 1», «Часть 2» — удержание аудитории
+- **Trending sounds** — увеличивают охват
+
+#### Алгоритмические best practices
+- 🟢 Completion rate > all (короче = выше completion)
+- 🟢 Hook в первые 1-3 секунды — критично
+- 🟢 Trending audio увеличивает охват
+- 🔴 Водяной знак другой платформы
+- 🔴 Контент с низким разрешением
+
+---
+
+### LinkedIn
+
+#### Форматы
+
+| Формат | Лимит | Видимость до «ещё» | Best for |
+|--------|-------|--------------------|----|
+| **Текстовый пост** | 3000 символов | Первые 210 символов | Инсайты, кейсы, opinion |
+| **Carousel (PDF)** | — | — | Образовательный, listicle, frameworks |
+| **Видео** | — | — | Expert talks, демо |
+| **Poll** | 4 варианта | — | Engagement, исследование мнений |
+| **Article** | Без лимита | — | Лонгрид, deep dive |
+
+#### Структура поста
+```
+[Hook — первые 210 символов. Инсайт, провокация или данные.]
+
+[Развитие — история, кейс, аргументы. Короткие абзацы, 1-2 предложения.]
+
+[Инсайт — неочевидный вывод, takeaway.]
+
+[Вопрос / CTA — вовлечь в дискуссию]
+
+·
+
+#хэштег1 #хэштег2 #хэштег3 (3-5 штук)
+```
+
+#### Engagement-приёмы
+- **Вопрос в конце** — запускает комментарии (dwell time + comments = охват)
+- **Личная история** — LinkedIn любит personal stories с профессиональным уроком
+- **Tag людей** — только релевантных, не спам-тегинг
+- **Ссылку в первый комментарий** — пост без ссылки получает больше охвата
+
+#### Алгоритмические best practices
+- 🟢 Dwell time (время чтения) — длинные посты с форматированием
+- 🟢 Комментарии в первый час — критичны
+- 🟢 Нативный контент > ссылки
+- 🔴 Ссылки в посте → -40-50% охвата
+- 🔴 Редактирование в первый час → сброс буста
+- 🔴 Engagement bait → penalty
+
+---
+
+### Telegram
+
+#### Форматы
+
+| Формат | Лимит | Форматирование | Best for |
+|--------|-------|---------------|---------|
+| **Текстовый пост** | 4096 символов | Markdown / HTML (жирный, курсив, ссылки, code) | Инсайты, новости, лонгриды |
+| **Пост + фото** | 1024 символа caption | Markdown | Визуальный контент + подпись |
+| **Пост + видео** | 1024 символа caption | Markdown | Видеоконтент |
+| **Опрос** | 10 вариантов, 300 символов/вариант | — | Engagement, исследование |
+
+#### Структура поста
+```
+**Заголовок жирным**
+
+[Первый абзац — суть, hook. 2-3 предложения.]
+
+[Развитие — тезисы, факты, аргументы. Форматирование: жирный для ключевых слов, буллеты для списков.]
+
+[CTA — ссылка, реакция, комментарий]
+
+#хэштег (1-3)
+```
+
+#### Engagement-приёмы
+- **Реакции** — попросить нажать реакцию (огонь = согласен)
+- **Forwards** — ценный контент пересылают → рост подписчиков
+- **Ссылка на обсуждение** — если есть чат канала
+- **Quiz** — бот-квиз для вовлечения
+
+#### Best practices
+- 🟢 Хронологическая лента — время публикации критично
+- 🟢 Forwards = главная метрика роста
+- 🟢 Форматирование (жирный, курсив, буллеты) увеличивает дочитывание
+- 🔴 Слишком длинные посты без структуры — не дочитывают
+- 🔴 Слишком частые посты (> 5/день) — mute
+
+---
+
+### YouTube
+
+#### Форматы
+
+| Формат | Лимит | Best for |
+|--------|-------|----|
+| **Long-form видео** | Title ≤ 100 (рекомендуется ≤ 70), Description ≤ 5000 | Deep dive, how-to, vlogs, interviews |
+| **Shorts** | Caption ≤ 100, видео ≤ 60 сек | Quick tips, тренды, hooks |
+| **Community Post** | Текст + изображение / poll | Engagement между видео |
+
+#### Структура описания
+```
+[Первые 2 строки — суть видео + CTA (видны без «ещё»)]
+
+[Таймкоды:]
+00:00 Intro
+01:30 [Тема 1]
+05:00 [Тема 2]
+
+[Ссылки:]
+🔗 [Ресурс 1]: [URL]
+🔗 [Ресурс 2]: [URL]
+
+[About:]
+[О канале, подписка, соцсети]
+
+#хэштег1 #хэштег2 #хэштег3 (≤ 15, первые 3 видны над названием)
+```
+
+#### Engagement-приёмы
+- **Подпишись + колокольчик** — голосовой CTA в видео
+- **Вопрос в конце** → комментарии
+- **End screen** — ссылка на следующее видео (последние 20 сек)
+- **Pinned comment** — CTA или вопрос закреплён
+
+#### Алгоритмические best practices
+- 🟢 CTR thumbnail > 5% — критичен для рекомендаций
+- 🟢 Average View Duration > 50% — главная метрика
+- 🟢 Таймкоды улучшают retention (зрители перематывают к нужному)
+- 🔴 Clickbait title без содержания → retention падает → алгоритм штрафует
+- 🔴 Первые 30 секунд без hook → drop off
+
+---
+
+### Twitter / X
+
+#### Форматы
+
+| Формат | Лимит | Best for |
+|--------|-------|----|
+| **Твит** | 280 символов (бесплатно) / 25000 (Premium) | Инсайты, мнения, новости, юмор |
+| **Thread** | Серия твитов | Deep dive, storytelling, listicle |
+| **Poll** | 4 варианта, 25 символов/вариант | Quick engagement |
+
+#### Структура thread'а
+```
+Твит 1: HOOK — самый сильный тезис. Должен захватить и мотивировать читать дальше. «🧵» в конце.
+
+Твит 2-N: По одному тезису на твит. Каждый — законченная мысль.
+
+Последний твит: CTA — «Ретвит если полезно», «Подписывайся на [тему]», ссылка на ресурс.
+```
+
+#### Engagement-приёмы
+- **Retweet с комментарием** — добавляет контекст
+- **Ответ на свой thread** — поднимает его в ленте
+- **Цитата-твит** — реакция на чужой контент
+- **Poll** — быстрый engagement
+
+#### Алгоритмические best practices
+- 🟢 Нативный контент > ссылки (ссылки снижают охват)
+- 🟢 Ответы и quote tweets увеличивают reach
+- 🟢 Визуал в твите увеличивает engagement
+- 🔴 Дублирование одного текста — penalty
+- 🔴 Массовый тегинг = спам
+
+---
+
+### Facebook
+
+#### Форматы
+
+| Формат | Лимит | Best for |
+|--------|-------|----|
+| **Пост** | 63206 символов (оптимально 40-80 слов) | Широкая аудитория, community |
+| **Stories** | 9:16, 15 сек/слайд | Quick updates |
+| **Reel** | 9:16, ≤ 90 сек | Вирусный охват |
+| **Event** | — | Офлайн/онлайн мероприятия |
+
+#### Структура поста
+```
+[Вопрос или факт — захват внимания]
+
+[Развитие — 2-3 коротких абзаца]
+
+[CTA — вопрос для комментариев / ссылка]
+```
+
+#### Best practices
+- 🟢 Видео и Reels получают больше охвата
+- 🟢 Группы — engagement выше чем на страницах
+- 🔴 Engagement bait → penalty (с 2024 усилено)
+- 🔴 Ссылки снижают охват (нативный контент лучше)
+
+## Адаптация ToV по платформам
+
+| Платформа | Тон | Особенности языка |
+|-----------|-----|-------------------|
+| **Instagram** | Дружеский, вдохновляющий, визуальный | Emoji допустимы (1-3), короткие абзацы, пустые строки |
+| **TikTok** | Разговорный, энергичный, authentic | Сленг ЦА, юмор, «живой» язык — не корпоративный |
+| **LinkedIn** | Профессиональный, экспертный, но human | Без emoji (или минимум), структура, данные, инсайты |
+| **Telegram** | Информативный, прямой, deep | Форматирование (жирный, буллеты), можно длиннее |
+| **YouTube** | Разговорный, вовлекающий | Как будто говоришь с другом, но экспертно |
+| **Twitter/X** | Острый, провокационный, лаконичный | Максимальная плотность мысли на символ |
+| **Facebook** | Тёплый, community-ориентированный | Вопросы, обращение к аудитории |
+
+> Адаптация тона ≠ изменение бренда. Тон адаптируется, ценности бренда остаются. Всё в рамках `$brand-guidelines`.
+
+## Протокол
+
+### Шаг 1 — Контекст
+1. Получить контент-бриф, платформу, персону.
+2. Если формат не указан — определить по Decision Tree.
+3. Загрузить ToV из `$brand-guidelines` + адаптацию по платформе.
+
+### Шаг 2 — Адаптация текста
+1. Применить **лимиты платформы** (символы, хэштеги).
+2. Написать **hook** в первых N символах (до «ещё»).
+3. Структурировать по **шаблону платформы**.
+4. Адаптировать **тон** по таблице ToV.
+5. Добавить **платформо-специфичные элементы** (хэштеги, emoji, @упоминания, форматирование).
+
+### Шаг 3 — CTA
+1. Один CTA, адаптированный под платформу (из `$cta-optimization`).
+2. Для Instagram: «Сохрани / Подпишись / Напиши в комменты».
+3. Для LinkedIn: вопрос для дискуссии.
+4. Для Telegram: ссылка или реакция.
+
+### Шаг 4 — Engagement-приёмы
+1. Выбрать **1-2 приёма** из списка платформы.
+2. Встроить органично — не spam, не engagement bait.
+
+### Шаг 5 — Алгоритмическая проверка
+1. Проверить по best practices платформы (🟢/🔴).
+2. Убедиться, что нет penalty-триггеров.
+
+### Шаг 6 — Форматные шаблоны (если применимо)
+Если формат — карусель, thread, reel — применить соответствующий шаблон.
+
+## Валидация (Quality Gate)
+
+Адаптация считается готовой если:
+
+- [ ] Платформа и формат определены
+- [ ] Лимиты символов соблюдены
+- [ ] Hook в первых N символах (до «ещё») захватывает внимание
+- [ ] Структура соответствует шаблону платформы
+- [ ] ToV адаптирован (не корпоративный текст в TikTok, не мемы в LinkedIn)
+- [ ] CTA присутствует, адаптирован под платформу
+- [ ] Хэштеги в правильном количестве
+- [ ] Нет алгоритмических penalty-триггеров
+- [ ] Engagement-приёмы встроены органично
+- [ ] Если карусель/thread — шаблон соблюдён
+
+## Handoff
+
+| Потребитель | Как использует |
+|-------------|---------------|
+| `$content-brief` | Формат и структура как часть брифа |
+| Copywriter (агент) | Пишет текст по шаблону платформы |
+| Visual Concept (агент) | Карусели, обложки reels — визуальное оформление |
+| `$content-review-checklist` | Ревьюер проверяет адаптацию |
+| `$platform-compliance` | Техническая проверка (лимиты, правила) |
+| `$content-release-gate` | Финальная проверка перед публикацией |
+
+## Интеграция с другими скилами
+
+| Скил | Взаимодействие |
+|------|----------------|
+| `$content-brief` | **Источник:** тема, тезисы, CTA, персона |
+| `$audience-analysis` | **Источник:** персона → тон и язык |
+| `$brand-guidelines` | **Источник:** ToV → адаптация по платформе |
+| `$platform-strategy` | **Источник:** какие платформы, форматы, частота |
+| `$cta-optimization` | **Источник:** CTA адаптированный под платформу |
+| `$headline-formulas` | **Источник:** hook / заголовок |
+| `$platform-compliance` | **Потребитель:** проверка правил платформы |
+| `$platform-visual-specs` | **Потребитель:** размеры для визуалов |
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Копипаст одного текста на все платформы | Разные платформы = разные правила, тон, лимиты | Адаптация текста, тона, CTA под каждую |
+| Корпоративный тон в TikTok | Аудитория не вовлекается, скроллит | Разговорный, authentic, с юмором |
+| Мемы в LinkedIn | Непрофессионально, unfollow | Экспертный тон, данные, инсайты |
+| Ссылка в посте Instagram | Некликабельна — пустой CTA | «Ссылка в bio» или стикер в Stories |
+| 30 хэштегов в Instagram | Выглядит как спам, не увеличивает охват | 3-5 релевантных |
+| Thread без hook в первом твите | Никто не раскроет — пролистают | Первый твит = самый сильный тезис |
+| Engagement bait | Penalty алгоритма | Искренний вопрос, не «лайкни если дышишь» |
+| Reel без hook в первые 3 сек | Scroll away → алгоритм не продвигает | Текст на экране + голос в первые 1-3 секунды |
+
+## Шаблон вывода
+
+```
+### Social Media Format — [Платформа]
+
+**Контент-бриф:** [ID / тема]
+**Платформа:** [платформа]
+**Формат:** [пост / карусель / reel / thread / stories / видео]
+**Персона:** [из $audience-analysis]
+**ToV:** [адаптация из $brand-guidelines]
+
+---
+
+#### Адаптированный текст
+
+**Hook (до «ещё»):**
+[первые N символов — захват внимания]
+
+**Тело:**
+[адаптированный текст по шаблону платформы]
+
+**CTA:**
+[адаптированный CTA]
+
+**Хэштеги:**
+[#хэштег1 #хэштег2 ... (количество по платформе)]
+
+---
+
+#### Форматный шаблон (если карусель / thread / reel)
+
+| Элемент | Содержание |
+|---------|-----------|
+| [Слайд 1 / Твит 1 / Hook 0-3 сек] | [содержание] |
+| [Слайд 2 / Твит 2 / Контекст 3-15 сек] | [содержание] |
+| ... | ... |
+| [Последний / CTA] | [содержание] |
+
+---
+
+#### Engagement-приёмы
+1. [Приём 1 — как встроен]
+2. [Приём 2 — как встроен]
+
+#### Алгоритмическая проверка
+| Правило | Статус |
+|---------|--------|
+| [🟢 best practice 1] | ✅/❌ |
+| [🔴 penalty trigger 1] | ✅ Нет / ⚠️ Есть |
+
+---
+
+**Лимиты:**
+| Параметр | Лимит | Факт | Статус |
+|----------|-------|------|--------|
+| Символов | [N] | [N] | ✅/❌ |
+| Хэштегов | [N] | [N] | ✅/❌ |
+| [другое] | [лимит] | [факт] | ✅/❌ |
+
+**→ Следующий шаг:** → Visual Concept (если нужен визуал) → `$content-review-checklist` → `$platform-compliance` → `$content-release-gate`
+```

package/domains/content/.agents/skills/social-media-formats/agents/claude.json

@@ -0,0 +1,10 @@
+{
+  "name": "social-media-formats",
+  "display_name": "Форматы соцсетей",
+  "description": "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook",
+  "default_prompt": "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\".",
+  "triggers": ["social-media-formats", "Форматы соцсетей", "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"],
+  "capabilities": ["social-media-formats"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/social-media-formats/agents/copilot.json

@@ -0,0 +1,10 @@
+{
+  "name": "social-media-formats",
+  "display_name": "Форматы соцсетей",
+  "description": "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook",
+  "default_prompt": "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\".",
+  "triggers": ["social-media-formats", "Форматы соцсетей", "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"],
+  "capabilities": ["social-media-formats"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/social-media-formats/agents/gemini.json

@@ -0,0 +1,10 @@
+{
+  "name": "social-media-formats",
+  "display_name": "Форматы соцсетей",
+  "description": "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook",
+  "default_prompt": "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\".",
+  "triggers": ["social-media-formats", "Форматы соцсетей", "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"],
+  "capabilities": ["social-media-formats"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/social-media-formats/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Форматы соцсетей"
+  short_description: "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"
+  default_prompt: "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/content/.agents/skills/social-media-formats/agents/qwen.json

@@ -0,0 +1,10 @@
+{
+  "name": "social-media-formats",
+  "display_name": "Форматы соцсетей",
+  "description": "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook",
+  "default_prompt": "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\".",
+  "triggers": ["social-media-formats", "Форматы соцсетей", "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"],
+  "capabilities": ["social-media-formats"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/social-media-formats/agents/skill.yaml

@@ -0,0 +1,20 @@
+version: 1
+name: "social-media-formats"
+display_name: "Форматы соцсетей"
+description: "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"
+default_prompt: "Используй $social-media-formats, когда задача относится к навыку \"Форматы соцсетей\"."
+triggers:
+  - "social-media-formats"
+  - "Форматы соцсетей"
+  - "Форматы и правила адаптации контента под Instagram, Telegram, LinkedIn, X, Facebook"
+capabilities:
+  - "social-media-formats"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"