AirsupHQ/machine-skill

O que é?

Recursos principais

• 01Cria um modelo 3D da máquina descrita em um único arquivo HTML, sem etapa de build.
• 02Executa um solver de física específico para cada máquina, que controla o movimento e os valores exibidos.
• 03Oferece modos de desmontagem, corte com faces de seção sólidas, raio X e rótulos em tempo real.
• 04Inclui um modo de falha calculado para simular falhas e cargas.
• 05Grava filmes MP4 determinísticos por meio de um script Node, com música opcional.

Casos de uso

• Criar uma página interativa explicando um motor ou mecanismo para fins didáticos.
• Produzir um vídeo animado curto de uma máquina para publicar nas redes sociais.
• Incorporar um modelo 3D em corte de um equipamento em um site de treinamento ou documentação.
• Explorar como as condições de operação alteram os valores do modelo de uma máquina.

Início rápido

1. 1

   Instale a skill no Claude Code

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

   Descreva no Claude Code a máquina que você quer construir

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

   Grave a página gerada como um vídeo (requer Node e ffmpeg)

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

Antes de usar

• !É voltado principalmente para máquinas, motores, mecanismos e dispositivos; os resultados são menos satisfatórios para pessoas, paisagens e mapas.
• !A física usa um modelo pequeno e simplificado, não CFD nem FEA, e os valores não são certificados.
• !Páginas pesadas precisam de uma GPU real compatível com WebGL 2 para funcionar na velocidade máxima.
• !Para gravar vídeos, são necessários Node 18 ou superior, Playwright e ffmpeg.

Em coleções

Tópicos

Perguntas frequentes

O que é machine-skill?

Uma skill do Claude Code que transforma uma descrição de uma máquina em uma simulação 3D interativa baseada em física e em um curta-metragem, tudo em um único arquivo. Machine Skill é uma Agent Skill de código aberto para o Claude Code. A partir de uma descrição de uma linha, como a de um motor turbofan ou do mecanismo de um relógio mecânico, o Claude pesquisa as dimensões reais e o ponto de operação da máquina e então a constrói como uma página HTML autocontida, usando three.js no navegador. A página inclui um pequeno solver de física específico para cada máquina (por exemplo, um ciclo Brayton para turbinas a gás ou um modelo biela-manivela para motores a pistão), que controla o movimento e os valores exibidos.

machine-skill é gratuito? Qual é a licença?

machine-skill é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

machine-skill ainda é mantido?

Manutenção ativa. O último commit de machine-skill foi em 13 de out. de 2026.

Para que posso usar machine-skill?

Criar uma página interativa explicando um motor ou mecanismo para fins didáticos. Produzir um vídeo animado curto de uma máquina para publicar nas redes sociais. Incorporar um modelo 3D em corte de um equipamento em um site de treinamento ou documentação. Explorar como as condições de operação alteram os valores do modelo de uma máquina.

Como instalar machine-skill?

Instale a skill no Claude Code: npx skills add AirsupHQ/machine-skill -g -a claude-code Descreva no Claude Code a máquina que você quer construir: /machine a mechanical watch movement, the escapement ticking Grave a página gerada como um vídeo (requer Node e ffmpeg): node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

Onde consigo machine-skill?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AirsupHQ/machine-skill