
factory-skill
Describe a factory in one line. Claude builds it as a live 3D simulation you can run. Open source agent skill: real discrete event simulation, tilt-shift min…
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 factory-skill (claude-skill project) into my current project. Found on https://claudeers.com/factory-skill Repo: https://github.com/AirsupHQ/factory-skill Homepage/docs: https://www.airsup.ai/lab/factory-skill Detected install method: claude-skill → # copy this skill into .claude/skills/factory-skill/ Category: skills. Platforms: cli, api, web. 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.
# copy the skill dir into your project: # .claude/skills/factory-skill/ (or ~/.claude/skills/factory-skill/ for all projects)
git clone https://github.com/AirsupHQ/factory-skill
// compatibility
| Platforms | cli, api, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | NOASSERTION |
| Pricing | open-source |
| Language | JavaScript |
Factory
Describe a factory in one line. Claude builds it as a live 3D simulation you can run.
An open source agent skill: a tilt-shift miniature of your factory, driven by a real discrete event simulation.
Quick start
npx skills add AirsupHQ/factory-skill -g -a claude-code
Then, in Claude Code:
/factory a line that makes 2,000 e-bike motors a day
No API keys and nothing to npm install: the scripts use only Node built-ins and the page is one
self-contained HTML file.
What it does
Claude reads the line, writes the real process route (stations, cycle times, batches, breakdown rates, yields), sizes every station from demand, checks the line headless, and hands you one HTML file: a model factory on a table, seen through a tilt-shift lens, with machines that move while they work and product flowing between them. Under it runs a discrete event simulation. Every number on screen is computed by it:
- throughput per day against the target, with a sparkline per production hour
- takt, WIP and lead time
- utilization of every station, split into busy, blocked, starved and down
- the bottleneck, outlined in pulsing red on the floor
Click a station: add a machine, slide its cycle time or its buffer, and watch the queue drain and the bottleneck move. The inspector shows the sizing formula with its numbers and a 3 day forecast of the changed line from the same engine.
Gallery
![]() | ![]() | ![]() |
| "a line that makes 2,000 e-bike motors a day" stator, rotor and hub shell branches joined at assembly | "a bakery that bakes 10,000 croissants an hour" proofers, a 14 m tunnel oven and a spiral cooler as continuous dwell | "a battery cell gigafactory" a 4 GWh line, coating to formation, three shifts |
![]() | ![]() | ![]() |
| "a drone assembly line" flight controller SMT branch, calibration, flight test cage | "a craft brewery canning 6,000 cans an hour" filler, tunnel pasteurizer, case packer, robot palletizer | "a factory that builds 4 satellites a day" cleanroom bays, gantry cranes, thermal vacuum in batches of 4 |
All six were made by Claude with this skill, from the prompts above. Open any
examples/*/*.html in a browser, or try them at
airsup.ai/lab/factory-skill.
Install
The repository is the skill: a folder with a SKILL.md at its root.
| Command | |
|---|---|
| skills CLI, for you | npx skills add AirsupHQ/factory-skill -g -a claude-code |
| skills CLI, one project | npx skills add AirsupHQ/factory-skill |
| git, for you | git clone https://github.com/AirsupHQ/factory-skill.git ~/.claude/skills/factory |
| git, one project | git clone https://github.com/AirsupHQ/factory-skill.git .claude/skills/factory |
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 agents
Factory follows the Agent Skills format: a folder with a SKILL.md at its
root, plain scripts and references beside it. Any host that loads that format can use it. The skills
CLI installs it for other agents with -a <agent> (see npx skills --help for the list); in the
Claude apps you can upload the folder as a zip under Settings, Capabilities, Skills; the Claude Agent
SDK picks it up from .claude/skills/. The workflow needs a shell with Node 20 or later to run
check.mjs and build.mjs; a host without one can still follow SKILL.md and write the spec.
Usage
/factory a bakery that bakes 10,000 croissants an hour
/factory a battery cell gigafactory, three shifts, 4 GWh
/factory how many CNC machines do I need for 600 gearbox housings a week at 42 minutes each?
You do not have to name the skill: asking to see, size or simulate a production line loads it. Give real numbers when you have them (volumes, cycle times, machines you already own, shifts); Claude fills the rest with typical values and says which ones it assumed.
The headless tools work on their own too:
node scripts/check.mjs examples/ebike-motors/spec.js # size the line and run 5 production days
node scripts/build.mjs examples/ebike-motors/spec.js # write the self-contained page
node scripts/capture.mjs examples/ebike-motors/ebike-motors.html shot.png --query assemble=0
node scripts/record.mjs examples/ebike-motors/ebike-motors.html film.mp4 --secs 12 --query intro=1
check.mjs prints, per station, machines, capacity per day, busy, down, blocked, starved and
failures, then the forecast and the bottleneck:
station ct s batch mach cap/day busy down block starve fails
> Lamination press 22 1 1 2,448 76% 12% 12% 0% 19
Needle winding 150 1 7 2,481 74% 5% 9% 12% 140
...
forecast over 5 production days: 1,943 motors/day (97% of target), scrap 29.6/day
bottleneck: Lamination press (busy + down 88%) WIP at end 193 tokens lead time 72.6 min
How it works
| Layer | What it does |
|---|---|
SKILL.md | The method: read the line, state assumptions, write the process route with real numbers, size, check, build, look, answer with the finding |
runtime/des.js | Event driven DES: parallel machines, lognormal cycles, batches, joins, finite buffers with blocking after service, operation dependent breakdowns, scrap, shift calendar, seeded and deterministic. Same file in Node and the browser |
runtime/kit.js | 27 machines at real scale with moving parts and stack lights, 29 product shapes, people, forklifts, AMRs, trucks, racks, trees |
runtime/world.js | Layout of the line (branches, joins, folding long lines), hall, yard, diorama base, and every token placed where the simulation says it is |
runtime/look.js | The miniature: warm sun and soft shadows, GTAO, bloom on emissive parts only, a tilted band of focus, warm saturated grade |
runtime/app.js | HUD, inspector, what-if API, film mode |
vendor/three.bundle.js | three.js r185 and the addons used, MIT |
The model, its limits and the sizing rule are in references/des.md; typical
process numbers in references/process.md; the kit API in
references/kit.md; the look in references/look.md.
Requirements
Node 20 or later for the scripts (built-ins only). A WebGL2 browser for the page. Playwright is
optional, for capture.mjs and record.mjs.
Limits
One sink (no rework loops), no changeovers between variants, no shared labour pool, conveyors are buffers (material handling has no capacity of its own), and a breakdown of a continuous machine (tunnel oven, spiral) stops one slot rather than the whole machine. Numbers are as good as the cycle times Claude is given or estimates: the page shows its assumptions so you can change them.
Credits
Made by airsup, manufacturing simulation for hardware teams. Inspired by Anatomy, the skill that brings machines to life as isometric figures. MIT licence.
// faq
What is factory-skill?
Describe a factory in one line. Claude builds it as a live 3D simulation you can run. Open source agent skill: real discrete event simulation, tilt-shift miniature.. It is open-source on GitHub.
Is factory-skill free to use?
factory-skill is open-source under the NOASSERTION license, so it is free to use.
What category does factory-skill belong to?
factory-skill is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/factory-skill)
// retro hit counter
[](https://claudeers.com/factory-skill)
// reviews
// guestbook
// related in Claude Skills
An agentic skills framework & software development methodology that works.
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,…
💫 Toolkit to help you get started with Spec-Driven Development





