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.
- 评测生成时间(北京时间)
- 本报告引擎
- v3.17.3
- 当前引擎
- v3.17.3
规则版本一致,但报告只反映生成时的证据,不代表项目代码和安全状态始终不变。
进入后确认来源与额度,提交才会创建任务。
核对代码版本与送评文本摘要
仅记录实际送评的受限文本,不是完整仓库审计、安装结果或运行时安全保证。Stars、下载量和仓库元数据为采集时的独立信号,不属于此 commit 快照。
AirsupHQ/machine-skill @ e0bd066ac5beaf48512935de2fc0f0e55636853a目录树:6cc80415dc6b557cc76f8a327a974a30f4fbe643
README 来源:README.md
- README.md · 14057 字符
SHA-256: 3e4bf4c1de66bed0f0ac4277522d7f172f826a78937e41c7e8840298cb86961d - SKILL.md · 14555 字符
SHA-256: 1f71d2c90c9b1c0cca4b7af526b5a9721cb039638e872fb959173a5ec533611c - package.json · 493 字符
SHA-256: 21e6afaca6fe0bd92cdd1428652d5b1a3aa57e200a236634b500adcc91f37d71 - scripts/record.mjs · 7329 字符
SHA-256: fa7377c00e7187bc11f900cd181b5ae32c191383e17614afa1fdaf3682be2722 - scripts/shot.mjs · 3427 字符
SHA-256: affdf0584c66d1bdeb2d4bdac2ea635fb4d51194a29f43fb514aac84cfb4efab
摘要对应送评 UTF-8 文本,可能为限额节选,不等于 Git blob SHA。来源由采集方提供,摘要本身不证明来源真实性。
综合采用结论
存在需要人工复核的风险或证据不足
- 基础评测完成+25/25确定性评分与静态安全扫描已完成
- README 有效证据+25/2510,463 个去重后的有效字符
- 独立证据来源+16/204 类非重复证据,重复文件不叠加
- 仓库元数据+10/10已取得仓库状态与采用数据
- 活跃记录+5/5已取得最近提交时间
- AI 复核+15/15已完成结构化 AI 证据复核
本报告评了什么
综合分用于静态采用筛选,不是任务成功率,也不代表使用 Skill 后的能力提升。
- 静态检查范围
- 记录 5 个文件 · 39,861 字符
- 只检查采集到的受限文本与已知风险模式;未读取的脚本、依赖和运行环境不在结论内。
- AI 内容复核
- 已使用
- 复核送评文本的说明和设计,不是安装测试或实际任务执行。记录缺失时不推断已使用或未使用。
- 真实任务效果
- 本报告未提供实测证据
- 没有使用/不使用 Skill 的任务对照、重复运行或耗时与 token 成本结果。采用前仍需在隔离环境验证自己的任务。
脚本引用覆盖
已纳入文本静态扫描 2 项/未纳入 2 项
被选 Skill:SKILL.md
仅检查被选 Skill 的直接脚本引用,一跳读取,不跟进 imports 或依赖;不执行脚本,脚本文本不送入 AI 质量复核。已纳入只表示文本已扫描,不代表安全。
仅统计本记录中的可识别引用;未纳入或未记录的部分保持未知,不按安全通过处理。
查看 4 项引用明细
1. 已纳入
引用位置:
SKILL.md:13目标路径:
scripts/record.mjs文本已纳入静态扫描,不代表脚本安全。
2. 动态引用
引用位置:
SKILL.md:55目标含动态表达式,不能确定要读取的文件。
3. 路径不符合边界
引用位置:
SKILL.md:55引用不是允许的仓库相对路径。
4. 已纳入
引用位置:
SKILL.md:123目标路径:
scripts/shot.mjs文本已纳入静态扫描,不代表脚本安全。
一句话到机械短片的工作流
SKILL.md 按研究、建模、求解、评审、录制的时间顺序描述单一任务流水线
左右滑动查看完整图示
- • SKILL.md Workflow 第 1 步 Research the real machine
- • SKILL.md 第 8 步 Look at it like a critic(shot.mjs 四轮)
- • SKILL.md 第 9 步 The film(record.mjs 与 autoFilm)
- 通过: Agent Skills 格式校验 1/1 个通过
- 通过: 1 个有效 Skill 含可核实的指令步骤或示例
- Quick start:npx skills add AirsupHQ/machine-skill -g -a claude-code,输出 watch.html
- Record a film:node scripts/record.mjs examples/turbofan.html out/turbofan.mp4 --music freepd:...
- SKILL.md 第 8 步要求至少四轮评审并用 shot.mjs 输出 fps、零件数与三角形数
- Limits:physics is a small honest model, not CFD or FEA;Heavy pages want a real GPU
- Requirements:Node 18+、Playwright、ffmpeg 用于截图与影片
- 问题与用途描述
- 有效 README
- 安装或接入步骤
- 可执行示例
- 通过: Agent Skills 格式校验 1/1 个通过
- 发现系统进程或命令执行能力
- 设计分因边界与失败处理证据缺失,由 13 校准为 12
- 缺少限制、权限或边界
- 缺少错误处理或排障
- 缺少错误处理与排障章节,安装或录制失败时无指引
需要快速产出机械原理可视化页面的工程师或科普作者、为社交媒体制作机械短片的内容创作者、用 Claude Code 做交互式教学演示的教师
需要 CFD/FEA 级精度或制造公差数据的工程分析、无 GPU 或无法安装 Node/Playwright/ffmpeg 的离线环境、需要人物、地图、景观类可视化的场景
也有自己的公开项目?先免登录查已有报告;没有报告时,可保留地址继续登录评测。
查找我项目的报告 →process-executionscripts/record.mjs:20high confidenceimport { spawn, spawnSync } from 'no***ss'修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
process-executionscripts/record.mjs:112high confidenceconst r = spawnSync(FFMPEG, ['-y', '-l***el', 'error', '-i', ***, '-i', src, '-map', '0:v', '-map', '1:a', '-c:v', 'copy', '-af', af, '-c:a', 'aac', '-b:a', '192k', '-t', ***, '-mo修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
process-executionscripts/record.mjs:114high confidence} else spawnSync(FFMPEG, ['-y', '-l***el', 'error', '-i', ***, '-c', 'copy', '-m***gs', '+f***rt', OUT], { stdio: 'inherit' })修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
process-executionscripts/record.mjs:115high confidencespawnSync('rm', ['-f', silent])修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
dynamic-code-executionscripts/shot.mjs:36high confidenceif (opt('--js'))***t('--js'))***t('--then', 2.5)) * 1000) }修复:避免执行不可信字符串;使用明确的解析器、白名单或结构化指令。
dynamic-code-executionscripts/shot.mjs:44high confidenceif (st.js) await page.evaluate((s) => { const lab = window.__lab; return eval(s) }, st.js)修复:避免执行不可信字符串;使用明确的解析器、白名单或结构化指令。
- 01限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
- 02补充限制、权限或边界
- 03补充错误处理或排障
方法、证据与局限展开收起
GitHub Repository API
5 个文件 · 39,861 字符
v3.17.3 · AI 内容复核:已使用(deepseek-flash)
- 静态评测不会安装或执行项目代码
- 安全扫描基于高信号文件与已知模式,不能替代人工审计
- 流行度只反映采用程度,不代表安全或工程质量
- 脚本覆盖仅针对被选 Skill 中可识别的直接引用;不递归分析依赖,不执行脚本,脚本未送入 AI 质量复核
30 天热度趋势
README
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.
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
Gallery
Each machine was made from the single line under it. Click one to run it live.
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 machine | Real 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 materials | Physically 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 studio | A 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 physics | A 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. |
| Modes | Explode, 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.
| Command | Installs to | |
|---|---|---|
| skills CLI, for you | npx skills add AirsupHQ/machine-skill -g -a claude-code | ~/.claude/skills/machine |
| skills CLI, one project | npx skills add AirsupHQ/machine-skill | .claude/skills/machine |
| git, for you | git clone https://github.com/AirsupHQ/machine-skill.git ~/.claude/skills/machine | ~/.claude/skills/machine |
| git, one project | git 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:
- 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.
- Say what should move and what should break. "Rev it until the valves float" tells the solver what to compute.
- 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.mdis 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.jsis 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.mdholds 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 for | Notes | |
|---|---|---|
| Claude Code (or any Agent Skills host) | building machines | |
| A browser with WebGL 2 | running the pages | Desktop Chrome, Safari, Firefox, Edge. Phones work with a lighter load. |
| Node 18+, Playwright, ffmpeg | screenshots and films | npm 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




