Repolode
AirsupHQ

AirsupHQ/machine-skill

Навык для Claude Code, который превращает однострочное описание машины в автономную интерактивную 3D-симуляцию на основе физики и короткий фильм.

Звёзды
597
Форки
78
Открытые issues
4
Последний коммит
25 дней назад

Что это?

Machine Skill — это навык с открытым исходным кодом для Claude Code. Получив однострочное описание, например турбовентиляторного двигателя или механизма механических часов, Claude изучает реальные размеры машины и её рабочий режим, а затем создаёт автономную HTML-страницу с помощью three.js, которая работает в браузере. Для каждой машины страница включает небольшой физический решатель — например, модель цикла Брайтона для газовой турбины или кривошипно-шатунного механизма для поршневого двигателя. Он управляет движением и отображаемыми значениями.

На страницах доступны разборка на части, разрез с цельными поверхностями сечения, рентгеновский режим, замедленное воспроизведение, динамические подписи и режим расчётного разрушения, показывающий, например, какую нагрузку должен выдерживать корпус. В режиме фильма используется детерминированный таймер: поставляемый в комплекте скрипт Node.js может записать MP4 с дополнительной музыкальной дорожкой. Также предусмотрены проверки, отклоняющие пустые кадры пурпурного цвета.

Навык устанавливается в Claude Code с помощью npx или git, а страницы можно открыть с диска в любом браузере с поддержкой WebGL 2. Для записи нужны Node 18+, Playwright и ffmpeg.

Ключевые возможности

  • 01Создаёт автономную HTML-страницу с 3D-моделью описанной машины — без этапа сборки.
  • 02Запускает отдельный физический решатель для каждой машины, который управляет движением и отображаемыми значениями.
  • 03Предлагает разборку на части, разрез с цельными поверхностями сечения, рентгеновский режим и динамические подписи.
  • 04Включает режим расчётного разрушения для моделирования поломок и нагрузок.
  • 05Записывает детерминированные фильмы в MP4 с помощью скрипта Node.js, при желании добавляя музыку.

Сценарии использования

  • Создание интерактивной обучающей страницы с объяснением устройства двигателя или механизма.
  • Создание короткого анимированного ролика о машине для публикации в соцсетях.
  • Встраивание 3D-модели оборудования в разрезе в учебный сайт или документацию.
  • Изучение того, как изменение условий работы влияет на расчётные значения модели машины.

Быстрый старт

  1. 1

    Установите skill в Claude Code

    npx skills add AirsupHQ/machine-skill -g -a claude-code
  2. 2

    Опишите в Claude Code машину, которую хотите создать

    /machine a mechanical watch movement, the escapement ticking
  3. 3

    Запишите сгенерированную страницу как видео (требуются Node и ffmpeg)

    node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

Что важно знать

  • В первую очередь подходит для машин, двигателей, механизмов и устройств; результаты с людьми, пейзажами и картами обычно хуже.
  • Физика основана на небольшой упрощённой модели, а не на CFD или FEA; значения не сертифицированы.
  • Для работы тяжёлых страниц на полной скорости требуется настоящая GPU с поддержкой WebGL 2.
  • Для записи видео требуются Node 18 или новее, Playwright и ffmpeg.

В подборках

Темы

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

Что такое machine-skill?
Навык для Claude Code, который превращает однострочное описание машины в автономную интерактивную 3D-симуляцию на основе физики и короткий фильм. Machine Skill — это навык с открытым исходным кодом для Claude Code. Получив однострочное описание, например турбовентиляторного двигателя или механизма механических часов, Claude изучает реальные размеры машины и её рабочий режим, а затем создаёт автономную HTML-страницу с помощью three.js, которая работает в браузере. Для каждой машины страница включает небольшой физический решатель — например, модель цикла Брайтона для газовой турбины или кривошипно-шатунного механизма для поршневого двигателя. Он управляет движением и отображаемыми значениями.
machine-skill можно использовать бесплатно? Какая у него лицензия?
machine-skill распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
machine-skill всё ещё поддерживается?
Активно поддерживается. Последний коммит в machine-skill — 13 окт. 2026 г..
Для чего можно использовать machine-skill?
Создание интерактивной обучающей страницы с объяснением устройства двигателя или механизма. Создание короткого анимированного ролика о машине для публикации в соцсетях. Встраивание 3D-модели оборудования в разрезе в учебный сайт или документацию. Изучение того, как изменение условий работы влияет на расчётные значения модели машины.
Как установить machine-skill?
Установите skill в Claude Code: npx skills add AirsupHQ/machine-skill -g -a claude-code Опишите в Claude Code машину, которую хотите создать: /machine a mechanical watch movement, the escapement ticking Запишите сгенерированную страницу как видео (требуются Node и ffmpeg): node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon
Где скачать machine-skill?
Исходный код и инструкции по установке — на GitHub: https://github.com/AirsupHQ/machine-skill

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты