Skip to content

howitworks 0.1.0

Latest

Choose a tag to compare

@hariFED hariFED released this 17 Oct 17:51
· 2 commits to main since this release

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.