RuiC Pixel Explainer — скилл

Скилл превращает закадровый текст в 20-секундный пиксельный ролик 1920×1080 с озвучкой и проектом для правок.

  • 83 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Скрипты запускают браузер через `playwright` и `ffmpeg` и пишут файлы проекта на диск
  • Озвучка отправляет текст ролика на подключенный вами сервис синтеза речи
Все причины и проверки

hruiccc/ruic-pixel-explainer

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/ruic-pixel-explainer

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скрипты запускают браузер через `playwright` и `ffmpeg` и пишут файлы проекта на диск
  • Озвучка отправляет текст ролика на подключенный вами сервис синтеза речи

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл принимает текст для озвучки по одной строке на фразу, режет его на смысловые такты и придумывает для каждого видимое действие: карточка летит в коллекцию, поиск ничего не находит, ответ сверяется с образцом, дается награда. Затем кадры рисуются кодом как чистая функция времени и экспортируются по одному, поэтому один и тот же кадр дважды дает одинаковые байты, а правка одного слова перерисовывает только нужное место. Скилл выбирает один из двух путей по возможностям среды. Если есть генерация изображений, по эталонам делаются прозрачные таблицы движений персонажа 4×4 и половинчатые портреты. Без нее полуфигуру и маленького героя рисуют функции на Canvas. На выходе файл MP4 в 30 кадров в секунду, проект для правок, ключевые кадры и точные параметры. Озвучку подключают свою: HTTP-сервис или локальная команда синтеза речи.

Для кого. Авторам обучающих роликов и книжных разборов, которым нужно воспроизводимое пиксельное видео, а не запись экрана.

Подходит, если

  • Есть закадровый текст на 20 секунд, и его нужно превратить в ролик с героем, сценой и субтитрами
  • Идею «сохранить не значит выучить» надо показать действиями: ответ, проверка, ключ как награда
  • Среда умеет генерировать картинки, и по эталону нужны таблицы поз для двух персонажей
  • Среда без генерации картинок, и герои рисуются кодом без внешних моделей

Не подходит, если

  • Подробная иллюстрация нужна: крупный пиксель здесь задан намеренно, тонкие текстуры и мелкие детали идут против стиля
  • Хочется нейросетевую генерацию видео целиком: каждый кадр здесь рисуется кодом по времени
  • Ожидается готовая озвучка из коробки: встроенных голосов нет, синтез подключают самостоятельно

Пример запроса к агенту

Сделай по этому тексту 20-секундный ролик в пиксельном стиле «Сохранить не значит выучить»: код без генерации картинок, 1920×1080, с субтитрами.

Ограничения

Нужны `node` с `playwright`, `ffmpeg` и `python3`, а для регистрации таблиц персонажей еще Pillow и numpy. В шаблоне лежит только пример озвучки на 20 секунд, для нового ролика ее заменяют своей. Все тексты проекта на китайском, описание репозитория тоже. Эталонные кадры нужны лишь для калибровки стиля. Сам ролик остается оригинальным рисунком, посимвольное воспроизведение чужого видео автор не обещает. Лицензия на файлы шрифта Fusion Pixel 12px OFL-1.1 идет вместе с ним.

Как отключить. Удалите папку скилла `ruic-pixel-explainer` из `~/.agents/skills/` и ссылки, которые создал скрипт развертывания для Claude Code и Codex. Готовые проекты роликов лежат отдельно, там, куда вы их копировали.

Частые вопросы

Как поставить скилл?

Скопируйте репозиторий в `~/.agents/skills/ruic-pixel-explainer`. Для Claude Code и Codex автор синхронизирует его скриптом `deploy_skills.py --sync` из своего реестра. В обычной среде хватает самой папки со SKILL.md.

Чем отличаются два пути?

Путь A использует генерацию изображений: по эталону получаются таблицы поз 4×4 и портреты, которые затем регистрирует скрипт `register_actor_sheet.py`. Путь B рисует героев кодом на Canvas и не требует внешних моделей.

Почему ролик собирается кадр за кадром, а не записью экрана?

Запись экрана зависит от нагрузки и теряет кадры. Покадровый экспорт привязывает время к номеру кадра, поэтому код всегда дает те же кадры, и самопроверка при рендере сравнивает один кадр, снятый дважды.

Нужен ли свой голос?

Да. Скрипт `voice_track.py` принимает ваш HTTP-сервис или локальную команду синтеза, сначала проверяет подключение ключом `--check`, затем озвучивает фразы по одной, измеряет длительность и собирает дорожку по времени.

Что входит в результат?

Файл MP4 в 1920×1080 при 30 кадрах в секунду с озвучкой, проект, который можно править, ключевые кадры, текст озвучки и фактические параметры файла, проверенные через `ffprobe`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл делает 20–60-секундный ролик из вашей озвучки и реальных материалов в выбранном стиле, MP4 собирается локально.

СкиллРасширенный доступ53Звезды репозитория

Скилл рисует видео кодом: объясняющие ролики с озвучкой и промо-ролики для сайтов в 35 визуальных стилях, 16:9 и 9:16.

СкиллРасширенный доступ174Звезды репозитория

Скилл Claude Code: ролик с говорящим мультяшным ведущим, губы по вашему голосу, позы по словам, бренд и проверка синхронизации

СкиллРасширенный доступ72Звезды репозитория

Скилл для Claude Code и Codex, который превращает тему в озвученный анимационный ролик-объяснение на Remotion с субтитрами и главами

СкиллРасширенный доступ3,3 тыс.Звезды репозитория

Скилл для видеообъяснялок в стиле Khan Academy: перо рисует на доске, пока идет голос, один сценарий дает готовый MP4

СкиллРасширенный доступ156Звезды репозитория

Скилл для Claude Code собирает минутный ролик-объяснение в стиле Vox из одной темы: сценарий, кадры, анимация, озвучка и музыка.

СкиллРасширенный доступ220Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
RuiC Pixel Explainer (эта карточка)нет83
Pixel Art Studioнет111делает статичный пиксель-арт в коде Pillow, без озвучки и видео
anything2explainerнет3 262превращает тему в озвученный ролик с анимацией графики, но не в пиксельном стиле

Коротко о README

Описание на китайском показывает три 20-секундных образца и объясняет, чем видео отличается от генерации нейросетью: каждый кадр рисуется кодом. Дальше идут возможности, схема из семи шагов, выбор пути по возможностям среды, быстрый старт, таблица размеров, правила озвучки, список приемки и вопросы об «огрубленном» стиле, шрифте и озвучке.

Бейдж для README

Исходный SKILL.md

---
name: ruic-pixel-explainer
description: 生成粗像素 RPG 横屏讲解片,按实际生图能力分为参考角色生图与纯代码两条路线。有生图用4×4动作小人和独立半身表情图,无生图用半身、大头平面脸、无突出鼻子的代码角色;两路都配角色专属场景、语义组件与确定性MP4导出。适用读书讲解、像素讲堂、像《刻意练习》那种视频及大小人物样片。
user-invocable: true
metadata:
  dsh:
    compatibility: native
    requires:
      - node
      - ffmpeg
      - python3
      - curl
---

# ruic-pixel-explainer · 粗像素电影式讲解片

把知识点演成像素世界中的动作,交付带口播的 16:9 MP4 与可修改工程。默认 1920×1080 / 30 fps;时长、文案、人物、场景以用户这次要求为准。

## 先判断模式

- **新主题 / 新人物 / 新场景**:原创生成。参考片决定像素粗细、比例、灯光与节奏;人物与道具重新设计。
- **沿用已有一期**:只修改该期数据和需要的场景,保留其他期。
- **逐帧恢复参考视频**:仅在用户明确要求恢复素材或重建原画面时使用。恢复像素不是原创动画,也不能把整片画面包当成可编辑人物骨骼。详见 [references/reference-modes.md](references/reference-modes.md)。

## 先检查生图能力,再选路线

以本次宿主实际可调用的工具或使用者已配置且授权的图片生成后端为准。能读图片、目录里有一段生图脚本、或模型名称里写 img2,都不等于已具备可运行的生图能力。不为这条技能重复安装插件、下载模型或寻找密钥。

| 情况 | 路线 | 角色资源 |
|---|---|---|
| 有可用图片生成能力,用户未禁用 | **A 生图角色路线** | 参考图 → 每角色4×4透明动作表+独立半身表情表 → 注册PNG → Canvas场景 |
| 没有图片生成能力,或用户选择纯代码 | **B 代码角色路线** | 独立半身与Q版小人绘制函数 → 角色色表 / 发型 / 帽饰 / 动作 → Canvas场景 |
| 没有实时生图能力,但已有用户提供的有效角色PNG | 复用PNG接入A的渲染段 | 明确说明使用已有资产,不能称新生成 |

A开工读 [references/imagegen-route.md](references/imagegen-route.md),用 `scripts/register_actor_sheet.py` 与 `assets/imagegen-template/sprite-actor.mjs` 接入。B开工读 [references/code-route.md](references/code-route.md),复制已升级的 `assets/cinematic-template/`。无论哪路,都复用同一套字幕、讲解组件与导出器。

有工具但当前生成失败或额度受限时,说明实际限制,按任务允许的范围改用已有PNG或B,不偷偷称调用成功。用户硬性要求特定生图方法时,先完成可独立推进的文案、场景与资产需求,缺该方法的角色生成不能冒充完成。

已有React游戏工程 `~/Desktop/zcode/ai-explain-game/game/` 仍可用于完整地图、选择题、评分和通关流程,接口见 [references/pipeline.md](references/pipeline.md)。只在需要其交互时接入;旧14×21精灵不是当前角色规范,不能原样放大作大人物。

把模板复制到本次项目再改;不修改已验收的旧期。产线检查入口缺失时核实实际工程,不另装替代系统。权威源是 `~/.agents/skills/ruic-pixel-explainer/`,其他agent经软链使用。

## 视觉重点

用户希望的是**原片那种简单、可读的粗像素**,不是更精细的像素插画。不要默认加密集纹理、蒸汽朋克装饰、发丝、亮晶晶大眼或满屏棋盘光环。

Сообщить о проблеме