Repolode
Submit
AirsupHQ

AirsupHQ/machine-skill

A Claude Code skill that turns a one-line description of a machine into a single-file, physics-based interactive 3D simulation and a short film.

View on GitHubWebsite
Stars
593
Forks
78
Open issues
4
Last commit
25 days ago

What is it?

Machine Skill is an open source Agent Skill for Claude Code. Given a one-line description such as a turbofan engine or a mechanical watch movement, Claude researches the machine's real dimensions and operating point, then builds it as a self-contained HTML page using three.js in the browser. The page includes a small physics solver per machine (for example a Brayton cycle for gas turbines, or a slider crank model for piston engines) that drives the motion and the displayed numbers.

The pages support explode, cutaway with solid section faces, x-ray, slow motion, live labels, and a computed break mode that shows, for instance, the load a casing must hold. A film mode uses a deterministic clock so a bundled Node script can record an MP4 with an optional music track, and includes checks that reject blank magenta frames.

The skill installs into Claude Code with npx or git, and pages run from disk in any WebGL 2 browser. Recording requires Node 18+, Playwright and ffmpeg.

Key features

  • 01Builds a single-file HTML 3D model of a described machine, with no build step.
  • 02Runs a per-machine physics solver that drives motion and displayed values.
  • 03Offers explode, cutaway with solid section faces, x-ray and live labels.
  • 04Includes a computed break mode for simulating failures and loads.
  • 05Records deterministic MP4 films through a Node script with optional music.

Use cases

  • Creating an interactive explainer page of an engine or mechanism for teaching.
  • Producing a short animated video of a machine for a social media feed.
  • Embedding a cutaway 3D model of equipment in a training or documentation site.
  • Exploring how operating conditions change the numbers of a machine's model.

Quick start

  1. 1

    Install the skill into Claude Code

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

    In Claude Code, describe a machine to build it

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

    Record the generated page as a film (requires Node and ffmpeg)

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

Things to know

  • Works mainly for machines, engines, mechanisms and devices; people, landscapes and maps come out weaker.
  • The physics is a small simplified model, not CFD or FEA, and numbers are not certified.
  • Heavy pages need a real GPU with WebGL 2 to run at full speed.
  • Recording films requires Node 18+, Playwright and ffmpeg.

In collections

Claude Code tools, skills & pluginsAI agent skill librariesLearning & education toolsRobotics & embodied AI projects

Topics

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

FAQ

What is machine-skill?
A Claude Code skill that turns a one-line description of a machine into a single-file, physics-based interactive 3D simulation and a short film. Machine Skill is an open source Agent Skill for Claude Code. Given a one-line description such as a turbofan engine or a mechanical watch movement, Claude researches the machine's real dimensions and operating point, then builds it as a self-contained HTML page using three.js in the browser. The page includes a small physics solver per machine (for example a Brayton cycle for gas turbines, or a slider crank model for piston engines) that drives the motion and the displayed numbers.
Is machine-skill free to use? What license does it have?
machine-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is machine-skill still maintained?
Actively maintained. The last commit to machine-skill was on Oct 13, 2026.
What can I use machine-skill for?
Creating an interactive explainer page of an engine or mechanism for teaching. Producing a short animated video of a machine for a social media feed. Embedding a cutaway 3D model of equipment in a training or documentation site. Exploring how operating conditions change the numbers of a machine's model.
How do I install machine-skill?
Install the skill into Claude Code: npx skills add AirsupHQ/machine-skill -g -a claude-code In Claude Code, describe a machine to build it: /machine a mechanical watch movement, the escapement ticking Record the generated page as a film (requires Node and ffmpeg): node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon
Where can I get machine-skill?
The source code and installation instructions are on GitHub: https://github.com/AirsupHQ/machine-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects