shuohao-skills — набор из семи навыков для ИИ-агента, который помогает превратить роман в материалы для производства короткого сериала. Он разбивает работу на этапы: от плана адаптации и описаний персонажей до сценария, расстановки героев и раскадровки. Это способ вести связанные документы, а не команда для создания готового видео.
Семь навыков: от плана адаптации до ключевых кадров
Навык в этом репозитории — отдельная папка с файлом SKILL.md, где агенту описан порядок работы, и скриптами для проверки и оформления результата. Это не MCP-сервер и не самостоятельный видеоредактор. Если формат вам незнаком, сначала прочитайте, как устроены навыки для Claude и других агентов.
Работа над адаптацией начинается с novel-outline. Он готовит пять частей плана: заметки о переработке романа, состав персонажей, основные сюжетные события, краткие описания серий и список объектов для производства. В последнем есть таблица реквизита, который играет роль в сюжете. У навыка также есть режим проверки уже готового плана.
Дальше novel-characters собирает карточки героев: сведения о персонаже, подсказки для изображения внешности и голоса, листы с видами персонажа. novel-art описывает локации и реквизит, включая ориентиры для сохранения единого вида между сценами. Персонажи, визуальные решения и сценарий могут уточняться вместе, а не строго по очереди.
novel-script пишет сцены с чередованием действий и реплик. Он оценивает длительность серии по скорости чтения и собирает реплики каждого героя с подсказками для синтеза речи. novel-staging затем определяет начальное расположение людей в сцене: кто присутствует, где стоит или сидит и куда смотрит. Его основной входной файл — сценарий; описания локаций и изображения сцен помогают сделать расстановку точнее.
novel-storyboard превращает подготовленные сцены в раскадровку. Он делит материал на отрезки генерации до 15 секунд, монтажные склейки по 2–5 секунд и ключевые кадры. Навык также готовит материалы для дальнейшей работы с MiniMax H3 или Seedance. Раскадровка и производственные пакеты не равны готовому сериалу.
Седьмой навык, character-refs, работает отдельно от адаптации романа. По описанию персонажа он создаёт опорное изображение в полный рост, а затем — портрет, профиль, вид сзади и детали с опорой на первый ракурс. Он подходит и для оригинальной истории, но для генерации изображений ему нужен отдельный источник.
Кому пригодятся связанные документы, а кому хватит чата
Если вы ведёте адаптацию в Claude Code и снова объясняете агенту состав героев, детали реквизита и порядок событий, навыки помогут разнести эти решения по рабочим файлам. Вы сможете сверяться с планом, карточками персонажей и сценарием на следующих этапах. Набор рассчитан также на Codex и других ИИ-агентов, которые читают SKILL.md и запускают вложенные скрипты.
Если сценарий уже готов, а перед раскадровкой нужно согласовать положение людей и предметов, можно взять только novel-staging. Он принимает сценарий, подготовленный вне этого репозитория, и не требует установки остальных навыков. Если романа нет, но нужны согласованные изображения героя для собственной истории, можно взять только character-refs.
Набор не нужен, если вы ищете расширение для обычной переписки с нейросетью или хотите получать готовые ролики без работы над сценарием. Для процесса, в котором все рабочие материалы должны оставаться на русском языке, он тоже не выглядит готовым решением: проект ориентирован прежде всего на китайский, а поддержка русского для всей цепочки в README не заявлена.
Как установить shuohao-skills для Claude Code или Codex
README предлагает клонировать репозиторий и запустить установщик из его корня:
git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.shУстановщик обнаруживает Claude Code и Codex и создаёт символические ссылки на папки навыков. Это ссылки на файлы в клонированном репозитории, а не отдельные копии: после git pull переустанавливать навыки не нужно. Если нужен один навык, только Codex или удаление ссылок, README даёт такие варианты:
./scripts/install.sh novel-characters # just one skill
./scripts/install.sh --codex # only into codex
./scripts/install.sh --uninstall # remove the symlinksДля другого агента автор предлагает скопировать папку навыка в его каталог навыков, создать на неё символическую ссылку или загрузить SKILL.md напрямую. Агент должен уметь запускать скрипты Node.js. Нужен Node версии не ниже 18; скрипты используют стандартную библиотеку, поэтому устанавливать npm-зависимости по README не требуется.
Навыки используют квоту модели из вашей текущей сессии; отдельный API-ключ для основной цепочки не нужен. Для character-refs при первом использовании надо выбрать источник изображений: собственный ComfyUI с Qwen Image, генерацию изображений Codex с квотой плана ChatGPT, GPT Image 2 с ключом OpenAI API либо пользовательскую команду. Наличие такого варианта в списке не означает, что он уже настроен у вас; про самостоятельное размещение моделей читайте в материале о локальном запуске моделей.
Три команды из README для начала работы
Первый пример — установить только novel-characters, если вам нужны карточки героев, но не вся цепочка. Команда создаст ссылку на этот навык в обнаруженной среде, а не подготовит персонажей без участия агента:
./scripts/install.sh novel-characters # just one skillВторой пример пригодится, когда файлы нескольких этапов уже готовы. Сборщик найдёт в указанной рабочей папке данные плана, персонажей, визуальных решений, сценария и раскадровки, затем создаст одну HTML-страницу с разделами для имеющихся отчётов. Отчёт о расстановке и галерея character-refs в эту страницу не входят:
node scripts/report.mjs --from <demo-dir> --out report.htmlТретий пример — запустить самопроверки навыков перед работой с ними. Они проверяют логику скриптов, не обращаются к модели и не расходуют её квоту. Это проверка инструментов, а не оценка качества будущего сценария:
for f in skills/*/scripts/selftest.mjs; do node "$f"; doneЕсли вы используете расстановку, учтите ещё один ручной шаг. novel-staging выдаёт предложения о начальном положении героев для каждой сцены, но novel-storyboard пока не импортирует его файл staging.json автоматически. Принятые формулировки нужно передать агенту и попросить скопировать в первый отрезок соответствующей сцены.
Языковые ограничения и условия работы с проектом
Отчёты шести этапов можно вывести с английским интерфейсом через --lang en, но этот параметр не переводит содержание рабочих данных. README отдельно предупреждает: novel-characters пишет профили героев по-китайски даже для английского романа, а проверка отклоняет английский текст в этих полях. Для русскоязычной команды это существенное ограничение до установки, а не настройка, которую решит переключатель интерфейса.
Агенту потребуется читать рабочие файлы и запускать скрипты Node.js; для изображений character-refs обращается к выбранному генератору. Учитывайте этот доступ, прежде чем давать агенту свои материалы. В репозитории есть локальные самопроверки, но, по README, автоматической проверки через CI нет; автор тестировал проект только на macOS с Node 24. Работу на Linux и более старых версиях Node он не подтверждает, хотя минимальное требование указано как Node 18.
Репозиторий создан 6 августа 2026 года. На момент обзора у него 4712 звёзд и 646 форков, последний коммит датирован 15 октября 2026 года. Лицензия — Apache-2.0. Если китайскоязычные рабочие данные не подходят вашему процессу, число звёзд этого ограничения не снимет.
Источник: репозиторий eternityspring/shuohao-skills на GitHub.