claudeers.
// Claude Skills

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…

Actively maintained
91/100
last commit about 1 month ago
last release none
releases 0
open issues 0
// 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 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.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/factory-skill/   (or ~/.claude/skills/factory-skill/ for all projects)
// or clone
git clone https://github.com/AirsupHQ/factory-skill

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageJavaScript

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

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.

A one line prompt is typed, a miniature e-bike motor factory assembles itself station by station, product flows on the conveyors and the HUD shows throughput against target and the bottleneck.

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.

E-bike hub motor lineCroissant bakeryBattery cell gigafactory
"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
Drone assembly lineBrewery canning hallSatellite factory
"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 younpx skills add AirsupHQ/factory-skill -g -a claude-code
skills CLI, one projectnpx skills add AirsupHQ/factory-skill
git, for yougit clone https://github.com/AirsupHQ/factory-skill.git ~/.claude/skills/factory
git, one projectgit 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

LayerWhat it does
SKILL.mdThe method: read the line, state assumptions, write the process route with real numbers, size, check, build, look, answer with the finding
runtime/des.jsEvent 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.js27 machines at real scale with moving parts and stack lights, 29 product shapes, people, forklifts, AMRs, trucks, racks, trees
runtime/world.jsLayout of the line (branches, joins, folding long lines), hall, yard, diorama base, and every token placed where the simulation says it is
runtime/look.jsThe miniature: warm sun and soft shadows, GTAO, bloom on emissive parts only, a tilted band of focus, warm saturated grade
runtime/app.jsHUD, inspector, what-if API, film mode
vendor/three.bundle.jsthree.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.

41 views
★ 51 stars
unclaimed
updated about 1 month ago

// embed badge

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

// retro hit counter

factory-skill hit counter
[![Hits](https://claudeers.com/api/counter/factory-skill.svg)](https://claudeers.com/factory-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 factory-skill connects across the ecosystem