pcb-kit (somebox)

pcb-kit is KiCad tooling and agent skills for designing, checking and ordering circuit boards with Claude Code. It started as the scripts that every board in the author's hardware projects ended up copying, DRC summaries, fab files, previews and a schematic builder, and grew into a way of working with an agent on a board: describe the design in text, check it with scripts, and look at pictures of it along the way.

The kit holds the engine and each project keeps its own data. It has three parts: pcbkit, a Python package and CLI for checks, release files, enclosure outlines, EasyEDA import, net views, placement scoring, a maze router, a negotiated router, simulation runs and a schematic builder for Konnect; skills in SKILL.md form, used by Claude Code and pi; and templates and a library with the project skeleton, conventions and trusted parts.

The skills run tools on the user's machine, so they do their work in Claude Code or pi on a Mac that has KiCad 10. pcbkit new scaffolds a hardware repo with design documents, an empty KiCad project with library tables, scripts, a bomi project and a first commit, and pcbkit import-easyeda brings an EasyEDA Std schematic and PCB across with symbols and footprints into the project library and runs ERC, DRC and parity on the result. The kit also fits a board to a box from an enclosure.json, drawing the outline with notches around lid bosses, mounting holes with standoff rings, keep-outs, and a 1:1 fit-check PDF to print, cut out and screw onto the box.