# scenario-text-overlay

Рендерит точный текст и плашки в PNG через Mustache-шаблоны для наложения на графику и видео в Scenario.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 397 установок · ★ 1141
- Автор: scenario-labs
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/scenario-labs/skills/tree/HEAD/skills/scenario-text-overlay/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/scenario-text-overlay

## Что делает

Модели генерации картинок часто искажают буквы. Этот скилл решает проблему детерминированным рендерингом: агент готовит JSON-манифест с переменными Mustache, а скрипт `scripts/overlay.py` собирает прозрачный PNG. Поддерживаются обычные текстовые блоки и вёрстка на HTML/CSS со стилями, градиентами или тенями.

Под капотом скрипт задействует движок Chromium для сложных макетов либо библиотеку Pillow как запасной вариант для простого текста. Для работы скрипта требуется установить зависимости командой `pip install chevron pillow`. Если переменная в шаблоне пропущена, сборка сразу завершается ошибкой.

Финальное сведение слоёв выполняется не локально, а на платформе Scenario через вызов моделей `model_scenario-compose-image` или `model_scenario-compose-video`. Сводить слои вручную через Pillow или ffmpeg бессмысленно: готовый креатив должен оставаться на платформе рядом со своими слоями и шаблоном.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-text-overlay -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/scenario-text-overlay/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/scenario-text-overlay/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-text-overlay -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/scenario-text-overlay/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-text-overlay -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/scenario-text-overlay/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills scenario-text-overlay
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/scenario-text-overlay/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-text-overlay -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/scenario-text-overlay
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/scenario-text-overlay/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-text-overlay -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/scenario-labs/skills/tree/HEAD/skills/scenario-text-overlay/SKILL.md

## Когда брать
- наложить титры и дисклеймеры на сгенерированное видео
- отрендерить плашку с ценой или CTA без искажения букв
- создать прозрачный PNG с HTML-вёрсткой и тенями по шаблону
- подставить локализованные надписи через переменные Mustache

## Примеры запросов агенту
- Собери JSON-шаблон для плашки с дисклеймером и отрендери PNG через overlay.py
- Подготовь карточку с ценой и наложи её поверх промо-видео в Scenario
- Сделай оверлей с кнопкой CTA для баннера с холстом 1080x1920

## Похожие
- [pixijs-scene-text](https://affpapa.org/nevibecode/skills/pixijs-scene-text.md) — скилл · 5800 установок
- [moviepy](https://affpapa.org/nevibecode/skills/moviepy.md) — скилл · 1000 установок
- [chat-motion-overlay](https://affpapa.org/nevibecode/skills/chat-motion-overlay.md) — скилл · 829 установок
- [infographics](https://affpapa.org/nevibecode/skills/infographics.md) — скилл · 2000 установок
- [llm-icon-finder](https://affpapa.org/nevibecode/skills/llm-icon-finder.md) — скилл · 952 установки
- [codex-gpt-image-2-5-flare](https://affpapa.org/nevibecode/skills/codex-gpt-image-2-5-flare.md) — скилл · 475 установок

Из того же набора: [scenario-labs/skills](https://affpapa.org/nevibecode/by/scenario-labs/skills.md) — 68 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md