Sprue

Describe a hardware product in chat; get back a design, CAD, a checked bill of materials priced with offers read from real supplier pages, and a build plan. Idea to RFQ. Part of Tobias's World idea lab.

Install

You need Claude Code and Node 22.15 or newer. The CAD step also needs Python 3 with build123d (python3 -m pip install build123d; on Homebrew Python, install it in a venv and start Claude Code from there). Reading a board's files back (sprue verify) needs Python 3.12 or newer with gerbonara and shapely, in a venv of their own that sprue verify finds by itself: python3 -m venv --clear ~/.cache/sprue/venv && ~/.cache/sprue/venv/bin/python -m pip install --no-deps -r ~/.claude/skills/sprue/pipeline/pcb/requirements.txt (where python3 is older than 3.12, the name of a newer one, such as python3.12, in its place; SPRUE_PYTHON names another Python to use). For a keypad it also runs the firmware on an emulated Pico, which needs git, and the network once, to fetch CircuitPython, KMK and rp2040js into ~/.cache/sprue. Figure screenshots need Chrome or Chromium (set CHROME_PATH if it isn't found).

One line installs it (and, run again, updates it):

curl -fsSL https://anatomy-2.vercel.app/install | sh

It fetches the zip the site serves and puts the skill in ~/.claude/skills/sprue, replacing an older copy, and removes ~/.claude/skills/distinta, where it was installed under its old name. Then restart Claude Code and type /sprue. To remove it: rm -rf ~/.claude/skills/sprue ~/.claude/skills/distinta.

npx skills add B0tes/sprue -g -a claude-code installs it too. Keep -a claude-code: without it the installer asks which agents to install for and preselects your last answer, and if Claude Code isn't ticked, /sprue doesn't appear. npx skills update sprue updates it.

Use

A run has four stages, and you say yes before each next one starts:

1. Design. Claude works out the real numbers, the CAD, the bill of materials and the engineer checks of each part on its own, and draws the product as an interactive isometric figure. products/<slug>/view.html opens as soon as every part is drawn: hover a part to name it, press E to take it apart, use the arrow keys to walk the assembly steps. Then accept it, ask for an edit, or decline it. The page says what to type.
2. Inspect. The parts together, in one frame (below, "The whole product"): they fit, keep their gaps, stand up and do their job, with the checks of the parts together. Claude fixes what fails and inspects again, and asks you when a fix is yours to choose. The page shows the verdict, each problem, the risks the design accepts with their reasons, and what is not checked yet.
3. Source. Real offers from supplier pages and a quote that rounds up to packs and counts shipping. They show on the same page, under the design: pick another offer and watch the total move. Accept, swap a part, change a supplier, or edit the design.
4. Build. The build plan with its assembly steps, the order list as CSV and the fab files, in production/. A circuit board is proven first (/sprue verify, below), and only a verified one gets its files to order by hand. The page shows them too: choose a step and the figure shows it. Nothing gets ordered.

/sprue a 3x3 USB macro keypad for my desk          stage 1: design it and open the figure
/sprue accept macropad                             accept the current stage and go on to the next
/sprue edit macropad make the case 2 mm taller     change the design, redraw the figure, rebuild the CAD
/sprue decline macropad too big for my desk        decline the current stage, with a reason
/sprue next macropad                               where the run is, and what it does next
/sprue status macropad                             the four stages, their files, and what's next
/sprue figure macropad                             redraw the figure and open the page
/sprue inspect macropad                            check the parts together, fixing what fails
/sprue bom macropad                                the bill of materials (with cost and shop once quoted)
/sprue bom macropad sw                             one line: every offer for the batch, with links
/sprue swap macropad ctrl SparkFun                 buy a line from another shop, or swap the part
/sprue supplier macropad                           the shops in the order, subtotals and shipping
/sprue verify macropad                             prove the board: audit, read-back, firmware, then the order folder
/sprue view macropad                               open the page: figure, design, inspection, offers and quote, plan
/sprue example macropad                            copy the finished keypad run into products/ here

Each run writes products/<slug>/ in the current folder: the request, design numbers, CAD and its STL/STEP files, the figure (figure.mjs), the BOM, checks, offers, quote, build plan, state.json with where each stage stands, for a product with a board pcb/ with the Gerbers (and pcb/order/ once sprue verify has passed them) and for a keypad firmware/, production/ with the order list and the fab files, and view.html, the one page that shows it all. Ask for the whole run without stopping and it goes through all four stages, then asks once at the end.

This is the beginning of the README. Read the rest at the original. Read the full README ↗