claudeers.
// Claude Skills

machine-skill

Describe any machine in one line. Claude builds a photoreal, physics based, interactive simulation of it in one HTML file, plus the film to post it. An open…

// Claude Skills[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#agent-skills#claude-code#claude-skill#cutaway#engineering#physics#simulation#skills◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
91/100
last commit about 1 month ago
last release none
releases 0
open issues 1
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up machine-skill (claude-skill project) into my current project.
Found on https://claudeers.com/machine-skill
Repo: https://github.com/AirsupHQ/machine-skill
Homepage/docs: https://airsup.ai/lab/skill
Detected install method: claude-skill → # copy this skill into .claude/skills/machine-skill/
Category: skills. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/machine-skill/   (or ~/.claude/skills/machine-skill/ for all projects)
// or clone
git clone https://github.com/AirsupHQ/machine-skill

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Machine Skill

Describe any machine in one line. Claude builds the real thing, running on real physics.
A photoreal, interactive 3D simulation in one HTML file, plus the film to post it. An open source skill for Claude Code.

 

The launch film: one typed line becomes a turbofan that assembles part by part, opens up to about 340 kN of computed thrust, is cut open and throws a fan blade, then a rocket engine fires and burns through its throat.

Every frame above is three.js in a browser, recorded with this repo's own scripts/record.mjs. Every number on screen is computed.


/machine a turbofan jet engine, the kind that pushes a widebody off the runway

Claude researches the real machine, writes down its real dimensions and the physics that make it work, and builds it: a 2.9 m fan of twisted titanium airfoils, a 10 stage compressor, an annular combustor with 22 fuel nozzles, two turbines glowing at the temperatures a Brayton cycle solver computes, on a ground run stand. You drag the throttle and about 340 kN comes out of the cycle, not out of a table. You cut it open and the section faces are solid metal. You throw a fan blade and the solver tells you the imbalance load the case has to hold.

Then one command turns it into a film for your feed.

Quick start

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

Then in Claude Code:

/machine a mechanical watch movement, the escapement ticking

You get watch.html: open it, drag, cut, explode, break. To film it:

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

Each machine was made from the single line under it. Click one to run it live.

A high bypass turbofan on a ground run stand, cut open with red section faces and live labelsA full flow methalox rocket engine firing on a horizontal test stand
Turbofan · a turbofan jet engine, the kind that pushes a widebody off the runway
Brayton cycle: about 340 kN at take-off, 83 % of it from the bypass. 3,597 parts. Break: throw a fan blade, and the solver computes the load the case must hold.
Rocket engine · a Raptor style full flow rocket engine on a test stand
Chamber and nozzle solution: 2,462 kN and Isp 321 s at 330 bar, sea level, Mach 4.06 at the exit. Break: cut the regen cooling and the copper throat melts.
An API 610 overhung process pump with its motor and seal pot, cut open with red section faces and live labelsAn API 617 barrel compressor cut open to show six impellers, diaphragms and return channels
Process pump · a refinery process pump, API 610 style, cut open for plant training
Pump curve with the affinity laws, BEP, NPSH available against required, seal face leakage. Hover any part for what it does and what the operator checks. Break: drop the tower level and it cavitates.
Compressor · a multistage centrifugal compressor for a refinery, cut open
Six stages on one map: polytropic head, stage pressure ratios, surge line, anti-surge control, a lumped surge model. Break: trip the downstream unit with the anti-surge valve stuck and it surges.

The pages are in examples/: each is one HTML file you can open from disk. More machines are coming; see V2-IDEAS.md, and send yours as a pull request.

What you get

The real machineReal proportions in metres, 15 to 40 named parts and thousands of solid pieces (blades, teeth, bolts), lathe turned solids, cambered and twisted airfoils, involute gears, routed pipes. A scale bar shows real size.
Real materialsPhysically based steel, titanium, Inconel, copper, brass, aluminium, paints, polymers, glass and sapphire, with measured reflectances, micro finishes (turned, brushed, cast), clearcoats and heat glow from the solver's temperatures.
A studioA softbox environment with black flags, a soft key shadow, contact shadow, ambient occlusion, bloom, a paper seamless or a night set. It looks like a product photograph before it moves.
Real physicsA small solver per machine (Brayton cycle, rocket chamber and nozzle, slider crank and BMEP, torsional oscillator, Cp(lambda, beta), pump curves, Kienzle, Darcy) drives every motion and every number. "How it is computed" shows the equations.
ModesExplode, cutaway with solid section faces, x-ray, slow motion, live labels, pause, and a computed "break it".
A film?film=1 gives a deterministic clock. One command records a 28 s film in numbered beats: you type one line, Claude builds it part by part, it runs, it opens, it comes apart, it breaks. Music bed included, magenta frame guard and pink scan built in.

Install

Machine Skill is a standard Agent Skill: a folder with a SKILL.md at its root. This repository is that folder.

CommandInstalls to
skills CLI, for younpx skills add AirsupHQ/machine-skill -g -a claude-code~/.claude/skills/machine
skills CLI, one projectnpx skills add AirsupHQ/machine-skill.claude/skills/machine
git, for yougit clone https://github.com/AirsupHQ/machine-skill.git ~/.claude/skills/machine~/.claude/skills/machine
git, one projectgit clone https://github.com/AirsupHQ/machine-skill.git .claude/skills/machine.claude/skills/machine

Claude Code picks up new skills in a running session; if the skills folder did not exist when the session started, run /reload-skills.

Other agent hosts
  • Claude.ai and the Claude desktop app: zip this folder and upload it under Settings, Capabilities, Skills. The pages run in any browser; recording needs a machine with Node and ffmpeg.
  • Claude Agent SDK / API with skills: mount the folder as a skill directory; SKILL.md is self contained.
  • Codex, Cursor, other agents that read Agent Skills: point them at SKILL.md. Everything else is plain files.
  • No agent at all: copy kit/template.html, fill the four sections by hand.

Usage

Type /machine and name the machine. You can also just ask Claude to "build", "simulate" or "show how X works"; the skill loads itself for machines, engines, mechanisms and devices.

/machine a hydroelectric Francis turbine
/machine a Swiss lever escapement, slowed down so I can see the impulse
/machine the gearbox of a 5 MW wind turbine, cut open
/machine a steam locomotive's valve gear, and give me a 30 second video for X

Three habits get the best machines:

  1. Name the real thing. "A turbofan like the ones on a 787" beats "a jet engine": Claude looks up the real dimensions and operating point.
  2. Say what should move and what should break. "Rev it until the valves float" tells the solver what to compute.
  3. Say where it goes. A page to embed, a film for X (1080 x 1080 or 1080 x 1350 with --w/--h), or a still for a slide.

Record a film

node scripts/record.mjs examples/turbofan.html out/turbofan.mp4 --music freepd:Classical/Easy_Lemon
node scripts/record.mjs examples/turbofan.html out/turbofan-feed.mp4 --w 1080 --h 1350
node scripts/record.mjs examples/turbofan.html out/stills --stills 3,9,14,19
node scripts/pinkscan.mjs out/*.mp4

The page runs with ?film=1&shot=main: time only moves when the recorder steps it, so every frame is fully rendered and a take is identical every time. --ss 1.5 supersamples, --blur 2 adds motion blur, --fps 60 for very fast motion. Music: any file, URL, or freepd:<Category>/<Name> (CC0 tracks from FreePD via archive.org). The recorder guards every screenshot against the solid magenta frames a stalled headless GPU can return and scans the finished film; it exits non zero if a pink frame got through.

The launch film at the top was directed in a browser page, film/launch.html, that embeds a live machine page and steps it frame by frame.

How it works

  • SKILL.md is what Claude reads: the bar a result must clear, the workflow (research, geometry, materials, solver, effects, modes, four critic rounds, the film), and the writing style on screen.
  • kit/lab-kit.js is the runtime every page inlines (one ES module, no build step, three.js 0.170 from a pinned CDN). Studio, post stack, material library with section caps, geometry builders, explode, cutaway, x-ray, labels, flow streaks, plumes, sparks, rigid debris, the editorial layer and the film timeline.
  • references/solvers.md holds solver recipes with real constants for gas turbines, rockets, piston engines, watches, rotors, pumps, machine tools, porous flow and electric machines.
  • scripts/: shot.mjs (screenshots for the critic rounds, prints fps, parts and triangles), record.mjs (films), pinkscan.mjs, inline.mjs (paste the kit into a page).
The cutaway, in one paragraph

Every part is a closed solid with a double sided material clipped by two planes (a half or a quarter section). Where the planes open a solid, the camera sees that solid's back faces; the material's shader recognises them by casting the view ray against both planes, and draws them as the section face instead: plane normal, plane depth (written to the depth buffer so it occludes correctly), a freshly machined colour of the same material and a faint hatch. No cap geometry, any cut position, so the cut can sweep in live.

Repository layout
machine-skill/
├── SKILL.md                 what Claude reads
├── kit/
│   ├── lab-kit.js           the runtime (inlined into every page)
│   └── template.html        the page Claude starts from
├── references/solvers.md    physics recipes with real constants
├── scripts/                 shot, record, pinkscan, inline (+ lib: server, browser, guard, png)
├── examples/                the example machines, one HTML file each, and their posters
├── film/launch.html         the launch film director page
└── evals/evals.json         prompts and what a good answer contains

Requirements

Needed forNotes
Claude Code (or any Agent Skills host)building machines
A browser with WebGL 2running the pagesDesktop Chrome, Safari, Firefox, Edge. Phones work with a lighter load.
Node 18+, Playwright, ffmpegscreenshots and filmsnpm i -D playwright && npx playwright install chromium; ffmpeg from your package manager.

Limits

  • It builds machines. Mechanisms, engines, instruments, devices. People, landscapes and maps come out weaker.
  • The physics is a small honest model, not CFD or FEA. Each page says what it computes and what it simplifies. Numbers are checked against public figures, not certified.
  • Real parts, not a CAD export. Geometry is procedural three.js; it is accurate in proportion and part count, not to manufacturing tolerance.
  • Heavy pages want a real GPU. About 600k triangles with shadows, AO and bloom runs at 60 fps on a recent laptop.

Siblings and credits

  • Factory skill: the same idea for whole factories. Describe a line in one sentence and Claude builds it as a live discrete event simulation.
  • Anatomy by Ryan (@wheresryan22) showed how good a one line machine skill can be. Its numbered beat film inspired ours.
  • airsup.ai/lab is where these machines come from: more than 50 simulations built with Claude Opus 5.5.
  • three.js (MIT), Instrument Serif, Inter and JetBrains Mono (OFL), music from FreePD (CC0).

License

MIT © 2026 Airsup · airsup.ai/lab

// faq

What is machine-skill?

Describe any machine in one line. Claude builds a photoreal, physics based, interactive simulation of it in one HTML file, plus the film to post it. An open source Claude Code skill.. It is open-source on GitHub.

Is machine-skill free to use?

machine-skill is open-source under the MIT license, so it is free to use.

What category does machine-skill belong to?

machine-skill is listed under skills in the Claudeers registry of Claude-compatible tools.

41 views
★ 658 stars
unclaimed
updated about 1 month ago

// embed badge

machine-skill on Claudeers
[![Claudeers](https://claudeers.com/api/badge/machine-skill.svg)](https://claudeers.com/machine-skill)

// retro hit counter

machine-skill hit counter
[![Hits](https://claudeers.com/api/counter/machine-skill.svg)](https://claudeers.com/machine-skill)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how machine-skill connects across the ecosystem