Анатомия боевого скилла
Разбор реального нетехнического скилла, который превращает сырой транскрипт подкаста в восемь готовых ассетов. Ценен не содержанием, а устройством: там есть три вещи, которых нет ни в одном нашем скилле.
.claude/skills/podcast-production/SKILL.md.
Три вещи, ради которых это стоит читать
Назначение скилла
Превратить сырой транскрипт подкаста в 8 готовых ассетов, отданных прямо в чат как copy-paste-ready markdown — чтобы человек мог итерировать построчно.
Рабочий цикл: шесть шагов
Восемь ассетов
Раскрой любой — там видно, насколько конкретны ограничения. Это и есть отличие рабочего скилла от описательного.
Ранжированы от лучшего к худшему, охватывают 2–3 разных паттерна. Без субтитров.
Формат: превью — 30–40 символов; заголовок — хук в начале, полная длина ~70–90 символов, имя гостя в конце.
Генерируется через отдельную под-команду /thumbnail-title.
Два варианта, которые можно смешивать. Каждый — 5–7 дословных цитат на 30–45
секунд. Формат строки: Speaker (MM:SS): "точная цитата".
- Открывать разрывом любопытства: вау-цифра или интригующее утверждение — не общая постановка проблемы.
- Собирать связную арку: хук → сюрприз/подход → результат → мышление. Закрыть.
- Цитаты только из транскрипта, никогда из файлов примеров.
Формат: MM:SS - MM:SS | причина.
Цель — низкоценное: настройка и дубли, мёртвый эфир пока работают агенты, промо-язык, повторные объяснения, повторные вопросы, маркетинговые демо (резать 50%), общие примеры.
Особое внимание: первые ~10 минут — искать медленные места, быстрее выходить на ценность.
Но не резать: существенную высокоуровневую рамку — её подрезать, а не вырезать. Шутки и характер оставлять.
Формат описания YouTube. 7–9 таймкодов, стандартные три спонсора. Короче обычного. Без обращения «Дорогие подписчики».
Описание гостя: 2–3 предложения, ~300–330 символов — кто он, чем эпизод особенный, 2–3 главные темы.
Полноценный Substack-пост с топ-10 выводов. Может править живой черновик, если дать ему URL.
Переиспользует тот же вводный абзац и те же таймкоды, что и шоуноты — это отдельно прописанное правило против расхождения версий.
- Тизер — за день до выхода.
- Пост дня выхода — адаптирован под X / LinkedIn / Threads.
- Топ-5 выводов — на следующий день.
Три поста вместо одного — потому что жизненный цикл эпизода растянут во времени, и каждый пост решает свою задачу.
Что скилл сознательно НЕ делает
- Никаких HTML-файлов. Всё markdown прямо в чате — ради плотного диалога.
- Никакой публикации по умолчанию. Когда ассеты финальны и монтажёр залил эпизод,
публикация запускается отдельной командой
/podcast-publish: разложить шоуноты по площадкам и создать черновики.
Генерация — итеративная, её крутят десять раз. Публикация — одноразовая и необратимая. В одном скилле это опасное соседство.
Сквозные правила качества
- Прочитать транскрипт целиком.
- Переиспользовать один вводный абзац и одни таймкоды между шоунотами и рассылкой.
- Только дословные цитаты.
- Переводить жаргон для неспециалистов.
- Чинить ошибки распознавания.
- Прогонять всё через проверку на AI-штампы — длинные тире названы главным нарушителем.
Скилл, который правит сам себя
В конце прогона Claude читает собственный SKILL.md и приносит замечания:
Хочешь что-то тут поправить? Пара вещей, которые я заметил,
пока прогонял эпизод:
1. Строка 259 уже цитирует «The 4,000-company waitlist agent»
как хороший пример таймкода — это из ровно этого эпизода,
так что скилл согласован с тем, что мы сделали.
2. Нет указаний про рассинхрон спонсорской вставки. В чате
транскрипта ad-read не было, а в смонтированной версии он
стоит на 07:44. Скилл всегда включает «стандартные три
спонсора» — что верно, но стоит добавить примечание, что
спонсор рассылки должен совпадать с реальной вставкой,
когда она есть.Обрати внимание: он ссылается на номера строк собственной инструкции и на конкретный тайм-код прогона. Это не «что улучшить?» вообще, а точечные находки.
Обратная связь от автора скилла
Peter сам говорит: «этот скилл вроде как пытается делать слишком много вещей». Ответ Thariq — важная развилка:
Иногда тебе нужен скилл. Иногда — репозиторий с кучей скриптов, в котором ты работаешь: это скорее рабочее пространство. И скилл иногда может быть инструкцией, как создать это пространство. Чем больше у тебя накоплено скриптов и наработок, тем меньше агенту приходится делать с нуля.
То есть скилл — не всегда «инструкция к действию». Он может быть «инструкцией к обустройству места, где действие потом дешевле».
У наших скиллов есть Gotchas, но нет трёх ключевых узлов этой схемы.
eval.md+ самооценка до показа. Сейчас качество проверяет человек. Должен проверять скилл — механические проверки, которые агент обязан прогнать сам и починить провалы до выдачи результата: длина заголовка, число сцен, длительность против озвучки, наличие блока источников, вертикаль не кропнута.learnings.mdс записью после публикации. У нас петля рвётся: ролик вышел, отработал — и данные не вернулись. Шаг 6 её замыкает.- Само-ревизия скилла. Агент по итогам прогона предлагает правки в собственный SKILL.md. Сейчас это вручную и потому редко.
Прямая параллель: faceless-script-skill уже требует блок SOURCES — это
единственная наша механическая проверка такого рода. Её надо размножить на остальные скиллы.
И развилка «скилл vs воркспейс» — прямо про animation-bank: он уже устроен
как воркспейс (банк + индекс + бренды), а скилл — тонкий указатель на него. Это, оказывается,
правильная форма.