跳到主要内容
Supermarket
返回能力市场
Claude Skill
design
MIT

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.

AirsupHQAirsupHQ
59/ 100

公开评测 · 综合采用结论

存在需要人工复核的风险或证据不足

查看评测依据 查找我项目的报告基于公开项目证据,非安全认证或安装推荐
689stars
92forks
最近更新 1个月前
评测生成时间(北京时间)
本报告引擎
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。来源由采集方提供,摘要本身不证明来源真实性。

Evaluation report

综合采用结论

59
D
满分 100 · 静态采用参考
谨慎采用高风险
决策摘要

存在需要人工复核的风险或证据不足

96%
高置信度
80
文档
58
安全
82
质量
72
活跃
45
采用
  • 基础评测完成+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. 1. 已纳入

    引用位置:SKILL.md:13

    目标路径:scripts/record.mjs

    文本已纳入静态扫描,不代表脚本安全。

  2. 2. 动态引用

    引用位置:SKILL.md:55

    目标含动态表达式,不能确定要读取的文件。

  3. 3. 路径不符合边界

    引用位置:SKILL.md:55

    引用不是允许的仓库相对路径。

  4. 4. 已纳入

    引用位置:SKILL.md:123

    目标路径:scripts/shot.mjs

    文本已纳入静态扫描,不代表脚本安全。

How it works · 流程图

一句话到机械短片的工作流

SKILL.md 按研究、建模、求解、评审、录制的时间顺序描述单一任务流水线

AI 提取 · 证据约束

左右滑动查看完整图示

一句话到机械短片的工作流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)
五维表现
一句话生成带真实物理求解器的交互式3D机械HTML与短片,场景与示例具体;最大缺口是缺少错误处理与排障说明,失败路径仅靠录制脚本的粉色帧检测覆盖。
质量证据
  • 通过: 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 的离线环境、需要人物、地图、景观类可视化的场景

也有自己的公开项目?先免登录查已有报告;没有报告时,可保留地址继续登录评测。

查找我项目的报告 →
文档证据
80/100
问题与用途描述10 分
有效 README12 分
安装或接入步骤14 分
可执行示例16 分
输入、参数或工具说明11 分
输出或结果说明9 分
限制、权限或边界12 分
错误处理或排障8 分
许可证信息5 分
结构化章节3 分
安全证据
高风险
发现系统进程或命令执行能力
process-executionscripts/record.mjs:20high confidence
import { spawn, spawnSync } from 'no***ss'

修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。

发现系统进程或命令执行能力
process-executionscripts/record.mjs:112high confidence
const 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 confidence
spawnSync('rm', ['-f', silent])

修复:限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。

发现动态代码执行 API
dynamic-code-executionscripts/shot.mjs:36high confidence
if (opt('--js'))***t('--js'))***t('--then', 2.5)) * 1000) }

修复:避免执行不可信字符串;使用明确的解析器、白名单或结构化指令。

发现动态代码执行 API
dynamic-code-executionscripts/shot.mjs:44high confidence
if (st.js) await page.evaluate((s) => { const lab = window.__lab; return eval(s) }, st.js)

修复:避免执行不可信字符串;使用明确的解析器、白名单或结构化指令。

优先改进清单
  1. 01限制可执行命令与参数,禁止拼接用户输入,并采用最小权限沙箱。
  2. 02补充限制、权限或边界
  3. 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.

Claude Code skill Agent Skills compatible MIT license three.js 0.170 No build step

Live gallery   Install

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

Gallery

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