stick-scene — скилл, который оживляет сайт сценками с человечками из палочек

· 4 мин чтения
skills animation canvas frontend landing-page
📂 Исходный код на GitHub

Скилл, который учит агента рисовать анимированные сценки с человечками из палочек и встраивать их на страницу одним HTML-элементом. Внутри — шаблон сценки, автопроверка кадров и движений и подробные правила стиля.

stick-scene — скилл, который оживляет сайт сценками с человечками из палочек

Хороший лендинг объясняет продукт словами, хотя понятную картинку человек считывает за секунду. stick-scene — это скилл для Claude и других ИИ-агентов, который рисует такие картинки сам. Вы просите агента показать, что делает продукт, и получаете маленькую анимированную сценку: человечек из палочек тянет рычаг, конвейер штампует карточки, робот-агент чинит строку кода. Каждая сценка — это один элемент canvas без внешних зависимостей. В покое сценка едва заметно «дышит», а при прокрутке, клике или наведении проигрывает короткое действие.

Как установить и запустить

Установка — одна команда:

npx skills add nilbuild/stick-scene

После этого позовите агента в чате:

/stick-scene покажи, как наш CLI превращает YAML в JSON

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

Как агент делает сценку

В SKILL.md задан процесс из пяти шагов.

  1. Понять продукт. Агент читает README или лендинг и формулирует одну строку: что делает пользователь и что получает.
  2. Предложить метафоры. Две-три физические идеи: рычаг, штамп, конвейер, доска с наклейками. Метафора должна читаться с одного взгляда, без подписи, и заканчиваться видимым результатом — галочкой, штампом, чем-то, что загорается.
  3. Написать сценку. Код по шаблону: фиксированные координаты мира, затем «дыхание» в покое, затем таймлайн действия на 5–8 секунд. Обязателен атрибут label — простое предложение для программ чтения с экрана.
  4. Проверить кадры. Скрипт рендерит стоп-кадры на один лист, и агент смотрит на него как на картинку: ничего не обрезано, реквизит не закрывает лицо, руки лежат перед тем, что держат. Затем второй скрипт прогоняет сценку на 60 кадрах в секунду и ловит огрехи, которых на стоп-кадре не видно: сломанные суставы, руку сквозь лицо, скользящие ноги, рывки в начале и в конце. Проверки идут до сообщения «motion is clean»; две-три итерации — норма.
  5. Встроить в страницу. Агент копирует файлы в статику и вставляет элемент. На лендинге сценку оформляют карточкой со скруглёнными углами, рамкой и точечной сеткой, а после проверяют вид на ширине десктопа и телефона.

Встраивание в страницу

Сценка — это кастомный 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