Sufler Markup

---
name: sufler-markup
description: Размечает текст выступления для Суфлёра — веб-суфлёра, который показывает речь по одному слову. Сам решает, где поставить паузу, где замедлить или ускорить, что выделить акцентом, где остановиться для смены слайда и как разбить речь на разделы; слова автора не меняет. Используй всегда, когда пользователь просит разметить текст для суфлёра, расставить паузы и акценты в питче, спиче, тексте для видео, презентации, reels или сторис, подготовить текст к записи или чтению с экрана — даже если он не называет Суфлёр и не упоминает разметку, а просто присылает текст выступления со словами «сделай для суфлёра», «расставь паузы», «подготовь к записи». Also use it for English requests: "mark up my script for Sufler", "add pauses and emphasis to my pitch for the teleprompter", "prepare this speech for recording".
---

# Разметка текста для Суфлёра

[Суфлёр](https://sufler.artemslizhik.com) показывает речь по одному слову в одной точке экрана, чтобы при записи видео глаза не бегали по строчкам. Темп управляется разметкой внутри текста. Твоя задача — взять обычный текст пользователя и вернуть тот же текст с разметкой, расставленной так, как расставил бы опытный спичрайтер или диктор: паузы там, где слушателю нужно время, замедление на главном, ускорение на второстепенном.

Отвечай на языке пользователя, а текст выступления оставляй на его языке: скилл работает с текстами на любом языке.

## Синтаксис (ровно то, что понимает Суфлёр)

| Разметка | Что делает |
|---|---|
| `/` `//` `///` | Короткая (0,5 с), обычная (1 с) и длинная (2 с) пауза. Отдельным токеном, через пробелы |
| `[PAUSE 1.5]` | Пауза точной длины в секундах |
| `[STOP]` | Остановка до нажатия пробела |
| `*слово*`, `*два слова*` | Акцент: цвет + подчёркивание, показывается ×1,15 дольше |
| `[SLOW] … [/SLOW]` | Участок медленнее (×0,75) |
| `[FAST] … [/FAST]` | Участок быстрее (×1,3) |
| `[SPEED 0.9] … [/SPEED]` | Свой множитель скорости |
| `[любой текст]` | Ремарка: мелко над ближайшим словом (или над паузой, если она идёт следом), минимум 1,8 с. Не читается вслух |
| `# Заголовок` | Раздел. На экране не показывается; на паузе по разделам можно прыгать, чтобы перезаписать дубль |

Что Суфлёр делает сам, без разметки:
- запятая, точка с запятой, двоеточие, тире — небольшая пауза; точка, `!`, `?`, `…` — пауза побольше;
- пустая строка между абзацами — ещё одна пауза;
- длинные слова показываются дольше коротких (по числу слогов).

Поэтому не дублируй пунктуацию: `/` после каждой запятой делает речь рваной. Ручная пауза нужна там, где смысл требует остановки сверх того, что уже дают знаки.

## Главное правило: слова — автора

Не меняй, не добавляй и не удаляй слова, не исправляй стиль и не переставляй фразы. Пользователь будет произносить это на камеру; его формулировки — его решение, и любая правка должна быть видимой, а не спрятанной внутри разметки. Можно:
- добавлять разметку;
- разбивать текст на абзацы и вставлять строки-разделы `#`;
- менять переносы строк и пробелы.

Пунктуацию оставляй как есть: вместо того чтобы превращать запятую в точку, поставь `/` или `//`.

Если в тексте есть то, что мешает читать вслух (см. «Что вынести в советы»), не исправляй сам — перечисли после текста. Исключение: пользователь прямо попросил отредактировать или адаптировать текст для речи. Тогда правь, но явно скажи, что поменял.

## Как решать, где что ставить

Сначала прочитай текст целиком и пойми его драматургию: с чего начинается, где проблема, где решение, где главный тезис, где призыв. Разметка должна подчёркивать эту структуру, а не равномерно покрывать текст.

**Паузы.** Пауза даёт слушателю время понять сказанное, а говорящему — вдохнуть. Ставь их:
- после приветствия или представления (`/`);
- перед главной мыслью, панчлайном, неожиданным поворотом (`//`) — пауза создаёт ожидание;
- после сильной цифры или факта, чтобы он осел (`//`);
- после риторического вопроса, будто даёшь зрителю ответить (`//` или `[PAUSE 1.5]`);
- на стыке «проблема → решение», «было → стало» (`//`);
- `///` — редко: переход между крупными блоками, перед финальной фразой;
- внутри длинного предложения без знаков (больше ~20 слов) — `/` в месте, где естественно вдохнуть.

Ориентир по плотности: одна ручная пауза на одно-два предложения. Если паузы стоят в каждой строке, они перестают что-либо значить.

**Акценты.** Выделяй одно ключевое слово на абзац, изредка два: цифры, название продукта, слово-контраст («не *дорого*, а *доступно*»), слово, на которое падает логическое ударение. Не выделяй целые предложения: когда выделено всё, не выделено ничего.

**Замедление `[SLOW]`.** Главный тезис, ключевая цифра, сложный термин, призыв к действию. Держи участки короткими, в пределах одного предложения: замедление работает на контрасте.

**Ускорение `[FAST]`.** Вводные и связки («как вы знаете», «кстати»), перечисление очевидного, дисклеймеры, повторения. Тоже коротко. Если в тексте нет ничего второстепенного, не ставь `[FAST]` вообще.

Всегда закрывай `[SLOW]`/`[FAST]`/`[SPEED]`: незакрытый тег меняет скорость до конца текста.

**Стоп `[STOP]`.** Только там, где говорящему нужно что-то сделать: сменить слайд, показать продукт или демо, задать вопрос залу. Подсказки в тексте: «на следующем слайде», «посмотрите», «давайте покажу», «вот как это выглядит». Если пользователь сказал, что будут слайды, ставь `[STOP]` на границах слайдов, насколько их можно угадать. Без таких признаков стоп не нужен.

**Ремарки `[…]`.** Короткая подсказка к действию или интонации, 1–3 слова: `[улыбнись]`, `[в камеру]`, `[жест]`, `[вдох]`, `[серьёзно]`, `[с иронией]`. Ставь перед словом, к которому относится действие; перед паузой ремарка покажется во время паузы (`[улыбнись] //`). Две-три на минуту речи — максимум: это подсказки, а не сценарий.

**Разделы `#`.** Делят речь на логические блоки: вступление, проблема, решение, доказательства, призыв. Нужны для дублей: на паузе можно сразу прыгнуть к разделу. Названия короткие, 1–3 слова. Для текста меньше ~120 слов разделы обычно не нужны, для 2–5 минут речи хватает 3–7.

**Абзацы.** Если текст идёт сплошной стеной, раздели его пустыми строками по смыслу: каждый абзац — одна мысль. Пустая строка сама по себе даёт паузу.

## Процесс

1. Возьми текст из сообщения или файла. Учти контекст, если он есть: формат (reels, питч инвесторам, доклад), тон, будут ли слайды, целевая длительность.
2. Разметь по правилам выше.
3. Проверь скриптом. Сохрани исходный и размеченный текст во временные файлы и запусти:
   ```bash
   node <путь-к-скиллу>/scripts/check.js marked.txt --original original.txt --wpm 140 [--target 1:30]
   ```
   Скрипт сверяет слова с оригиналом, находит незакрытые теги, опечатки в командах, перебор акцентов, места без вдоха и считает длительность. Если есть ОШИБКИ, исправь и запусти снова. Предупреждения оцени по смыслу: если что-то оставляешь сознательно, так и скажи. Если Node недоступен, проверь те же пункты вручную.
4. Верни результат:
   - если текст пришёл файлом, сохрани рядом `<имя>.sufler.txt` и дай путь; иначе выведи размеченный текст одним блоком ```text, чтобы его можно было целиком скопировать в редактор Суфлёра (https://sufler.artemslizhik.com);
   - одной-двумя строками: длительность при 140 сл/мин (и скорость под цель, если её назвали), сколько разделов и стопов;
   - «Что вынести в советы», если есть что сказать. Не больше 5 пунктов.

Если пользователь просит переразметить (например «меньше пауз», «быстрее в начале»), меняй только разметку и снова прогони проверку.

## Что вынести в советы

Не правь сам, а перечисли после текста:
- **числа цифрами**, особенно с пробелами: «2 500 000» покажется тремя отдельными «словами». Предложи «2,5 миллиона» или словами;
- **сокращения и символы**: «т.е.», «%», «$», «и т.д.» — их неудобно произносить с листа;
- **очень длинные предложения** (больше ~30 слов) — предложи, где разбить;
- **английские термины и аббревиатуры**, если неясно, как их произносить;
- **повторы и канцелярит**, только если это заметно мешает речи.

## Пример

Исходный текст:
```text
Каждый день водители в Москве тратят около 20 минут на поиск парковки. Это почти 120 часов в год. Мы сделали Паркли, приложение, которое показывает свободные места в реальном времени. Как это работает? Датчики на парковках передают данные, а приложение ведёт вас к ближайшему месту. В пилоте на 5 000 водителях время поиска сократилось втрое. Сейчас мы привлекаем 30 миллионов рублей на запуск в трёх городах. Присоединяйтесь.
```

Размеченный:
```text
# Проблема
Каждый день водители в Москве тратят около *20 минут* на поиск парковки. //
Это почти 120 часов в год. //

# Решение
Мы сделали *Паркли*, / приложение, которое показывает свободные места в реальном времени.
Как это работает? /
Датчики на парковках передают данные, а приложение ведёт вас к ближайшему месту.

# Результаты
[STOP]
В пилоте на 5 000 водителях / [SLOW] время поиска сократилось *втрое*. [/SLOW] //

# Призыв
Сейчас мы привлекаем 30 миллионов рублей на запуск в трёх городах. ///
[в камеру] Присоединяйтесь.
```

Почему так: пауза после цифры проблемы даёт ей осесть; акцент на названии продукта при первом упоминании; короткая пауза после риторического вопроса; стоп перед результатами, где, скорее всего, слайд с графиком; результат замедлен и выделен, потому что это главный аргумент; длинная пауза перед призывом и ремарка «в камеру» на последнем слове.

Совет к этому тексту: «5 000» покажется как два слова, «5» и «000». Лучше написать «пяти тысячах».