anbeime/skill / skills/machine-skill/machine-skill
machine
VerifiedTurn one line ("a turbofan jet engine", "a mechanical watch", "an LVAD heart pump") into a photoreal, physics based, interactive 3D simulation of that machine in a single HTML file, plus a 20 to 30 second film to post it. Real proportions in metres, real materials (PBR metals, paints, polymers, glass), studio lighting with soft shadows, moving parts driven by a small solver that computes real numbers (thrust, torque, rpm, flow, pressure, efficiency), and modes to explode it, cut it open with clean section caps, x-ray it, slow it down, label it and break it. Use this whenever someone asks to build, simulate, visualise, explain or "show how X works" for any machine, engine, mechanism, device, instrument or piece of hardware, wants an interactive 3D model or a cutaway, or wants a video of a machine for a post, even if they never say "simulation" or "three.js".
CONTRIBUTING.md
View on GitHub# Contributing
Thank you for helping. Machine Skill gets better in three ways: better machines, a better kit, and a sharper SKILL.md.
## A new example machine
1. Start from the one line. Put it in `prompt` exactly as typed.
2. Follow SKILL.md step by step, including the research block at the top of the script and at least four review rounds with `scripts/shot.mjs`.
3. Keep the kit linked while you work (`<script type="module" src="../kit/lab-kit.js">`), then run `node scripts/inline.mjs examples/<id>.html` so the file stands alone.
4. Add a poster (`examples/posters/<id>.jpg`, 1600 x 1000) and a film made with `scripts/record.mjs`. The recorder must finish with `pinkscan clean`.
5. In the pull request, state the operating point your solver reaches and the public figure you checked it against.
## Kit changes (`kit/lab-kit.js`)
- Every example must still load without errors and look the same or better. Run `node scripts/shot.mjs examples/<id>.html out/<id>.png` for all of them and attach before and after images.
- New features go behind an option with today's behaviour as the default.
- No build step and no runtime dependency other than three.js from the pinned CDN.
## House rules
- Real units, real proportions, real constants. A number on screen must come from a solver.
- Calm editorial writing: short sentences, units with a space (`338 kN`), no hype.
- No em dashes or en dashes in code, comments or copy.
- Be kind in issues and reviews.
## Reporting a problem
Open an issue with the one line you typed, the browser and GPU, a screenshot, and anything in the console.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |