Repository navigation
An interactive engineering-drawing skill for Claude Code that explains mechanisms and software concepts through physical cutaways and live simulations.
Name a mechanism or an idea, and Claude picks the real machine whose working is the idea and drafts it as a live engineering sheet: a section through the mechanism, hatching by material, true dimensions, numbered balloons with part cards, a parts list and a title block, all driven by one physical model. Add 3d for a cutaway you can turn, cut open and take apart.
Install
npx howitworks
npx skills add hariFED/howitworks
/plugin install howitworks --marketplace hariFED/howitworks
Then: /howitworks explain how a four-stroke engine works
What's in 0.1.0
- 21 example sheets, 508 drawn parts: four-stroke engine, watch escapement, flyball governor, gear and centrifugal pumps, Stirling engine, disc brake, pressure cooker and more, plus software ideas as machines (rate limiting = cistern, back-pressure = relief valve, authentication = pin tumbler lock, debounce = door closer).
- A live 3D cutaway for every sheet: orbit, cut, explode, drive it.
- Part cards: hover, tap or focus any balloon to learn the part's size, material and what it does.
- The kit: pure SVG drafting functions, a live runtime, a 3D kit, and layout and 3D checks.
- Website: https://harifed.github.io/howitworks/
Films
Five short films about the project are attached below (720p, under 10 MB each): the monochrome launch film, plus mixed, Swiss, isometric and pen-and-wash cuts.