stick-scene — скилл, который оживляет сайт сценками с человечками из палочек
📂 Исходный код на GitHubСкилл, который учит агента рисовать анимированные сценки с человечками из палочек и встраивать их на страницу одним HTML-элементом. Внутри — шаблон сценки, автопроверка кадров и движений и подробные правила стиля.
Хороший лендинг объясняет продукт словами, хотя понятную картинку человек считывает за секунду. stick-scene — это скилл для Claude и других ИИ-агентов, который рисует такие картинки сам. Вы просите агента показать, что делает продукт, и получаете маленькую анимированную сценку: человечек из палочек тянет рычаг, конвейер штампует карточки, робот-агент чинит строку кода. Каждая сценка — это один элемент canvas без внешних зависимостей. В покое сценка едва заметно «дышит», а при прокрутке, клике или наведении проигрывает короткое действие.
Как установить и запустить
Установка — одна команда:
npx skills add nilbuild/stick-scene
После этого позовите агента в чате:
/stick-scene покажи, как наш CLI превращает YAML в JSON
Скилл читает ваш проект, предлагает две-три идеи на выбор, пишет сценку, проверяет кадры и добавляет готовый элемент на страницу. Правки тоже через диалог: «медленнее», «зацикли», «возьми наш фирменный зелёный», «пусть робот подумает, прежде чем начать».
Как агент делает сценку
В SKILL.md задан процесс из пяти шагов.
- Понять продукт. Агент читает README или лендинг и формулирует одну строку: что делает пользователь и что получает.
- Предложить метафоры. Две-три физические идеи: рычаг, штамп, конвейер, доска с наклейками. Метафора должна читаться с одного взгляда, без подписи, и заканчиваться видимым результатом — галочкой, штампом, чем-то, что загорается.
- Написать сценку. Код по шаблону: фиксированные координаты мира, затем «дыхание» в покое, затем таймлайн действия на 5–8 секунд. Обязателен атрибут
label— простое предложение для программ чтения с экрана. - Проверить кадры. Скрипт рендерит стоп-кадры на один лист, и агент смотрит на него как на картинку: ничего не обрезано, реквизит не закрывает лицо, руки лежат перед тем, что держат. Затем второй скрипт прогоняет сценку на 60 кадрах в секунду и ловит огрехи, которых на стоп-кадре не видно: сломанные суставы, руку сквозь лицо, скользящие ноги, рывки в начале и в конце. Проверки идут до сообщения «motion is clean»; две-три итерации — норма.
- Встроить в страницу. Агент копирует файлы в статику и вставляет элемент. На лендинге сценку оформляют карточкой со скруглёнными углами, рамкой и точечной сеткой, а после проверяют вид на ширине десктопа и телефона.
Встраивание в страницу
Сценка — это кастомный HTML-элемент. Скопируйте stick.js и файл сценки в папку статики и подключите их:
<script src="stick.js" defer></script>
<script src="my-scene.js" defer></script>
<stick-scene scene="my-scene" play="view" style="height: 230px"></stick-scene>
Атрибуты элемента:
| Атрибут | Что делает |
|---|---|
scene |
Идентификатор зарегистрированной сценки |
play |
Когда играть: view (по умолчанию — один раз при появлении на экране), click, hover, loop, idle |
no-floor |
Убрать полосу пола под сценкой |
no-ground |
Убрать линию земли |
zoom |
Масштаб рисунка, по умолчанию 1 |
label |
Текст для программ чтения с экрана; по умолчанию берётся из самой сценки |
no-font |
Не загружать шрифт Balsamiq Sans с Google Fonts |
Размеры задаются обычным CSS, родная высота — 230 пикселей. Сценка за пределами экрана ничего не рисует, а пользователям с включённой опцией «уменьшить движение» показывается один стоп-кадр вместо анимации.
Что внутри репозитория
- runtime/stick.js — ядро: скелет человечка, позы, плавность движений, перо, набор реквизита, сцена и сам HTML-элемент.
- templates/scene.js — стартовый шаблон новой сценки.
- templates/preview.html и scripts/frames.mjs — рендер стоп-кадров в один лист для проверки.
- scripts/motion.mjs — автопроверка движения на 60 кадрах в секунду.
- references/craft.md — шпаргалка по API, сборник поз, рецепты таймингов и каталог метафор.
- examples/ — десять готовых сценок: ревью кода, рычаг для песочницы с базой данных, конвертер YAML в JSON, пуш в GitHub Actions, вход по cookie, отправка письма, отчёт о затратах в Slack, ночная очередь задач. Самый чистый полный пример — diffity-review.js.
Правила стиля
Стиль выверен примерно на девяносто готовых сценках, и SKILL.md прямо запрещает придумывать новый. Ключевые правила:
- Чернила
#141414, белая заливка бумаги, один масляный акцент и много пустого места. - Шрифт Balsamiq Sans на 8,5–11 пикселей и всего несколько слов на сценку.
- Человечек — главный: его голову и активную руку нельзя закрывать реквизитом.
- Одна идея на сценку. Если без подписи непонятно, метафора выбрана неверно.
- Показывать результат, а не работу: финальный кадр — изменившееся состояние, которое держится мгновение.
- ИИ-агенты рисуются роботами: визор, светящиеся глаза, антенна, огонёк на груди, оранжевая или бирюзовая палитра.
- Чужие логотипы нельзя. Название продукта обычным текстом на реквизите — можно.
Кому пригодится
Скилл для тех, кто хочет добавить на сайт живую иллюстрацию без дизайнера и аниматора: демо в первый экран лендинга, картинку к фиче, весёлую виньетку в документацию. Лицензия MIT, автор — Камран Ахмед.
Источник: https://github.com/nilbuild/stick-scene