
Quack core
HeyPCB/quack-core
Brain board for the Open Duck Mini: Pi Zero 2W carrier, 14-servo STS bus, fused 2S power path in stitched copper zones (15-18 A battery side), USB-C charging with balancing, IMU.

A set of skills for Claude Code and Codex (Agent Skills format) plus pcbkit, a toolkit that is copied into each board project at a fixed version. Together they cover the whole KiCad 10 board flow:
Usb ldo is an open-source printed circuit board by kfihihc, from the kfihihc/pcb-pipeline repository on GitHub, published under the MIT licence. It is a 2-layer board of 25 × 18 mm with 9 parts on 6 nets, routed with 38 tracks and 3 vias.
It is built around the HT7533-1, CL21A106KAYNNNE and PZ254V-11-03P, with the USB4125-GF-A-0190 and KT-0603R among its other parts. Its parts include 3 resistors, 2 capacitors, 2 connectors, 1 IC and 1 diode.
English | 中文
A set of skills for Claude Code and Codex (Agent Skills format) plus pcbkit, a toolkit that is copied into each board project at a fixed version. Together they cover the whole KiCad 10 board flow:
requirements → parts → datasheet facts → official reference design comparison → schematic as code → simulation → rules, placement, routing → gate → review → release
flowchart LR
classDef agent stroke:#3987e5,stroke-width:2px
classDef human stroke:#d95926,stroke-width:2px
classDef tool stroke:#199e70,stroke-width:2px
S1(Requirements):::agent --> S2(Parts):::agent --> S3(Datasheets):::agent --> S4(Reference design):::agent --> S5(Schematic):::agent --> S6(Simulation):::agent --> S7(Layout):::agent
S7 --> G{8-check gate}:::tool
G -- fail --> S7
G -- pass --> R{{Review}}:::human --> P(Release):::agent --> B{{Bring-up}}:::human
B -- errata --> S1The principles:
Language. The skill instructions and the project documents are written in Chinese. Every skill description includes an English sentence to help agents identify relevant tasks in English; automatic selection has not been systematically evaluated.
docs/diagrams/.It grew out of an earlier survey of AI and EDA tools for hardware design (not part of this repository) and the experience of building a KiCad replica of an ESP32-S3 AMOLED board.
| Skill | What it does | Bundled scripts |
|---|---|---|
pcb-pipeline | Orchestrator: stages, artifacts, rules for transactional changes; creates or adopts a project; upgrades pcbkit | scripts/new_project.py, kit/, assets/template/ |
pcb-parts | Offline search of the JLCPCB/LCSC parts library, alternates, BOM stock and cost, live prices | scripts/jlc_parts.py |
pcb-datasheet | Datasheet download with provenance, per-page search and rendering, facts.toml with page references, pinout check against KiCad | scripts/datasheet.py |
pcb-refdesign | Export of official reference designs (KiCad, Altium, EAGLE, PDF), chip-centred surroundings, pin-by-pin comparison | scripts/refnet.py |
pcb-schematic | SKiDL circuit code → readable KiCad schematic; connectivity intent | (in the project: pcbkit/sch_gen.py) |
pcb-sim | SPICE benches, corners and assertions (libngspice) | (in the project: pcbkit/sim.py) |
pcb-layout | Board outline, rules, net classes, pours, keepouts; sync, placement, pre-routing; transactional routing with KiCadRoutingTools | scripts/setup_krt.sh |
pcb-gate | The 8-check gate, declarative metrics, CI, revision diff and change-scope check | (in the project: pcbkit/gate.py, metrics.py, board_diff.py) |
pcb-review | Review packet (KiCanvas, interactive BOM, PcbDraw drawings, EMC pre-check leads), reviewer plus devil's-advocate passes, findings turned into gate checks | scripts/setup_kicad_happy.sh (in the project: pcbkit/review.py) |
pcb-release | Fabrication and review package, JLCPCB BOM/CPL, interactive BOM, panelization (the user decides), pre-order checks, tagging | (in the project: pcbkit/release.py, extras.py) |
The gate runs these 8 checks:
.kicad_dru is otherwise dropped silently.| Needed for | Requirement |
|---|---|
| Everything | Linux with KiCad 10 from your distribution: kicad-cli and KiCad's pcbnew Python module. Tested with Debian's KiCad 10.0.6 and Python 3.14. pcbkit uses the system KiCad and never downloads its own copy |
| Datasheets | poppler-utils (pdftotext, pdfinfo, pdftoppm) |
| Simulation | libngspice (Debian: libngspice0, already pulled in by KiCad) |
| Board projects | uv for the Python dependency groups (SKiDL, router, optional outputs), and git |
| Tests only | rsync |
| The agent | Claude Code and/or Codex |
On Debian or Ubuntu:
sudo apt install kicad poppler-utils libngspice0 git rsync pipx
pipx install uv # or the installer from the uv websitegit clone https://github.com/kfihihc/pcb-pipeline.git
cd pcb-pipelineKeep the clone: the skills are installed as symbolic links into it.
install.sh links every folder under skills/ into the personal skill folders of Claude Code (~/.claude/skills/) and Codex (~/.codex/skills/). It links only into folders that already exist, so create the ones for the agents you use first:
mkdir -p ~/.claude/skills # Claude Code
mkdir -p ~/.codex/skills # Codex, only if you use it
./install.shExpected output, once per skill and agent:
linked /home/you/.claude/skills/pcb-pipeline
linked /home/you/.claude/skills/pcb-parts
...skip … (not present) means that agent's skill folder does not exist; create it and run ./install.sh again.CONFLICT … exists and is not a link means a skill of the same name is already installed. The script leaves it untouched; move it away first if you want this one.Install all ten skills. They refer to each other: the orchestrator hands work to the stage skills, and the release skill uses references from the layout skill.
./install.sh --checkThis lists every link (ok, missing or CONFLICT) and checks the dependencies: kicad-cli, poppler, uv, git, libngspice, the parts database, the router and kicad-happy.
Then start a new Claude Code session so it loads the skills, and try one of these:
/pcb-pipeline;The ten skills have been discovered in both Claude Code and Codex, and their instructions have been read in Codex. This verifies discovery and access, not an end-to-end board design run in both agents.
All of these go to ~/.cache/pcb-pipeline/, outside the repository:
| For | Command | Notes |
|---|---|---|
Parts search (pcb-parts) | python3 skills/pcb-parts/scripts/jlc_parts.py fetch --db current | JLCPCB parts database, about 180 MB |
Autorouting (pcb-layout) | skills/pcb-layout/scripts/setup_krt.sh | KiCadRoutingTools v0.22.1 with its own uv environment |
EMC pre-check (pcb-review, optional) | skills/pcb-review/scripts/setup_kicad_happy.sh | kicad-happy v2.3.1; only its analysis scripts are used, its skills are not installed |
The optional outputs (KiKit panel, InteractiveHtmlBom, PcbDraw) are installed per board project, in that project's uv environment: run uv sync --group extras in the project. kicanvas.js ships with pcbkit. docs/external-tools.zh-CN.md (Chinese) explains how these tools were chosen and why KiBot is not used.
Update the skills: git pull in the clone. The links pick up the change at once; start a new agent session.
Update a board project's toolkit: each project keeps its own copy of pcbkit, so upgrade it deliberately, on its own branch, then run the gate:
python3 <clone>/skills/pcb-pipeline/scripts/new_project.py <board> --update-kitRemove: ./install.sh --uninstall removes only the links that point into this clone.
.claude/skills/ instead of ~/.claude/skills/.skills/* also works, but then git pull no longer updates them.P=$PWD/skills # run inside the pcb-pipeline clone
python3 "$P/pcb-pipeline/scripts/new_project.py" ~/boards/my-board --name my-board --title "My board" --size 40x30
cd ~/boards/my-board && git init
# then tell Claude Code / Codex: "Design this board with pcb-pipeline. The requirements are ..."
python3 pcbkit/gate.py # the gate; run it at any timeTo adopt an existing KiCad project:
# Run from the pcb-pipeline clone; replace /path/to/existing-board.
python3 skills/pcb-pipeline/scripts/new_project.py /path/to/existing-board \
--adopt --pcb x.kicad_pcb --sch x.kicad_schSee examples/s3-adoption/ for a worked case.
tests/run_tests.sh # about 2 minutesThe suite runs the example's gate and negative tests for each check. It also covers simulation, reference designs, parts search, datasheets, and the optional outputs including panelization. A test whose data or tool is missing is skipped, not failed.
MIT, see LICENSE. This covers the skills, pcbkit, the documentation and the example designs.
New board projects default to MIT; use new_project.py --license <identifier> to choose another license. Check the upstream license when adopting or deriving an existing design.
Exceptions:
kicanvas.js (skills/pcb-pipeline/kit/vendor/ and its copy in the example) keeps its own MIT license and copyright, in kicanvas.LICENSE.md next to it.| Qty | Value | Footprint | References |
|---|---|---|---|
| 2 | 5.1k | Resistor_SMD:R_0603_1608Metric | R1, R2 |
| 1 | 10uF 10V | Capacitor_SMD:C_0603_1608Metric | C2 |
| 1 | 10uF 25V | Capacitor_SMD:C_0805_2012Metric | C1 |
| 1 | 1k | Resistor_SMD:R_0603_1608Metric | R3 |
| 1 | HT7533-1 | Package_TO_SOT_SMD:SOT-89-3 | U1 |
| 1 | Header 1x3 | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J2 |
| 1 | USB-C | Connector_USB:USB_C_Receptacle_GCT_USB4125-xx-x-0190_6P_TopMnt_Horizontal | J1 |
| 1 | red | LED_SMD:LED_0603_1608Metric | D1 |

HeyPCB/quack-core
Brain board for the Open Duck Mini: Pi Zero 2W carrier, 14-servo STS bus, fused 2S power path in stitched copper zones (15-18 A battery side), USB-C charging with balancing, IMU.

lightningspore/shieldsigner-dev
ShieldSigner Luckfox carrier: KiCad design, smartcard docs, reproducible build tools and HTMX knowledge site

offgridevices/offgrid-hardware
Open hardware from OffGrid Devices. One folder per board. CERN-OHL-S.


HeyPCB/led-art
Shaped LED boards inspired by films, each in its own colour: KiCad 10, JLCPCB-ready, CERN-OHL-S-2.0

HeyPCB/led-art-2
More shaped LED boards inspired by films, each in its own colour: KiCad 10, JLCPCB-ready, CERN-OHL-S-2.0

HeyPCB/quack-face
Face board for the Open Duck Mini's head: eye LEDs, projector driver, I2S amp and mic, antenna servos, shaped to the head. 4-layer KiCad 10 board plus printed standoffs, fit-checked in the head CAD.

johnb302/cmu-embedded
Repo for distributed embedded systems at CMU, 18-449
It measures 25 × 18 mm and has 2 copper layers, 1.6 mm thick.
9 parts, built around the HT7533-1, CL21A106KAYNNNE, PZ254V-11-03P and USB4125-GF-A-0190. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the kfihihc/pcb-pipeline repository on GitHub, at the commit this page was made from: the board is examples/usb-ldo/hw/usb-ldo.kicad_pcb and its schematic examples/usb-ldo/hw/usb-ldo.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).