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:
- 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.
- 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.
- 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.
- 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.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
