Repolode
Enviar
AirsupHQ

AirsupHQ/machine-skill

Una skill de Claude Code que convierte una descripción de una máquina en una simulación 3D interactiva basada en la física y un cortometraje.

Ver en GitHubSitio web
Estrellas
593
Forks
78
Issues abiertos
4
Último commit
hace 25 días

¿Qué es?

Machine Skill es una Agent Skill de código abierto para Claude Code. A partir de una descripción de una línea, como la de un motor turbofán o el mecanismo de un reloj mecánico, Claude investiga las dimensiones reales y el punto de funcionamiento de la máquina y luego la construye como una página HTML autocontenida que usa three.js en el navegador. La página incluye un pequeño solver de física para cada máquina (por ejemplo, un ciclo Brayton para turbinas de gas o un modelo de biela-manivela para motores de pistón) que controla el movimiento y los valores mostrados.

Las páginas admiten vista explosionada, corte con caras de sección sólidas, rayos X, cámara lenta, etiquetas en vivo y un modo de rotura calculada que muestra, por ejemplo, la carga que debe soportar una carcasa. El modo de película usa un reloj determinista para que un script de Node incluido pueda grabar un MP4 con una pista de música opcional, e incluye comprobaciones que descartan los fotogramas magenta en blanco.

La skill se instala en Claude Code con npx o git, y las páginas se ejecutan desde el disco en cualquier navegador compatible con WebGL 2. Para grabar se necesita Node 18+, Playwright y ffmpeg.

Funciones clave

  • 01Crea un modelo 3D de una máquina descrita en un único archivo HTML, sin necesidad de compilar.
  • 02Ejecuta un solver de física para cada máquina que controla el movimiento y los valores mostrados.
  • 03Ofrece vista explosionada, corte con caras de sección sólidas, rayos X y etiquetas en vivo.
  • 04Incluye un modo de rotura calculada para simular fallos y cargas.
  • 05Graba películas MP4 deterministas mediante un script de Node, con música opcional.

Casos de uso

  • Crear una página explicativa interactiva de un motor o mecanismo con fines educativos.
  • Producir un video animado breve de una máquina para publicar en redes sociales.
  • Incrustar un modelo 3D en corte de un equipo en un sitio de formación o documentación.
  • Explorar cómo las condiciones de funcionamiento cambian los valores del modelo de una máquina.

Inicio rápido

  1. 1

    Instala la skill en Claude Code

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

    Describe en Claude Code la máquina que quieres construir

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

    Graba la página generada como un vídeo (requiere Node y ffmpeg)

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

Antes de usarlo

  • Está pensado principalmente para máquinas, motores, mecanismos y dispositivos; los resultados son menos buenos con personas, paisajes y mapas.
  • La física utiliza un modelo pequeño y simplificado, no CFD ni FEA, y los valores no están certificados.
  • Las páginas pesadas necesitan una GPU real compatible con WebGL 2 para funcionar a máxima velocidad.
  • Para grabar vídeos se necesitan Node 18 o posterior, Playwright y ffmpeg.

En colecciones

Herramientas, skills y plugins para Claude CodeBibliotecas de skills para agentes de IAHerramientas de aprendizaje y educación de código abiertoProyectos de robótica e IA encarnada

Temas

#agent-skills#claude-code#threejs#webgl#simulation#physics#3d-visualization#education#claude#claude-skill

Preguntas frecuentes

¿Qué es machine-skill?
Una skill de Claude Code que convierte una descripción de una máquina en una simulación 3D interactiva basada en la física y un cortometraje. Machine Skill es una Agent Skill de código abierto para Claude Code. A partir de una descripción de una línea, como la de un motor turbofán o el mecanismo de un reloj mecánico, Claude investiga las dimensiones reales y el punto de funcionamiento de la máquina y luego la construye como una página HTML autocontenida que usa three.js en el navegador. La página incluye un pequeño solver de física para cada máquina (por ejemplo, un ciclo Brayton para turbinas de gas o un modelo de biela-manivela para motores de pistón) que controla el movimiento y los valores mostrados.
¿machine-skill es gratuito? ¿Qué licencia tiene?
machine-skill es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿machine-skill sigue mantenido?
Mantenimiento activo. El último commit de machine-skill fue el 13 oct 2026.
¿Para qué puedo usar machine-skill?
Crear una página explicativa interactiva de un motor o mecanismo con fines educativos. Producir un video animado breve de una máquina para publicar en redes sociales. Incrustar un modelo 3D en corte de un equipo en un sitio de formación o documentación. Explorar cómo las condiciones de funcionamiento cambian los valores del modelo de una máquina.
¿Cómo se instala machine-skill?
Instala la skill en Claude Code: npx skills add AirsupHQ/machine-skill -g -a claude-code Describe en Claude Code la máquina que quieres construir: /machine a mechanical watch movement, the escapement ticking Graba la página generada como un vídeo (requiere Node y ffmpeg): node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon
¿Dónde consigo machine-skill?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AirsupHQ/machine-skill

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados