AvatarSD/KiSkill / skills/kicad-layout
kicad-layout
VerifiedAutoroute a KiCad board headlessly: schematic → staged footprints → placement → freerouting → routed .kicad_pcb, DRC-gated. Use when asked to route a board, do layout from a schematic, or autoroute nets.
Headless layout / autorouting
Engine: $(kx root)/kicad_lib/layout.py
(python API: PYTHONPATH=; any freerouting-*-linux-x64 in .tools
is auto-detected, newest wins).
Worked end-to-end example: tests/test_layout.py (scratch board with
outline + 2 netted footprints → 9 routed segments).
The chain
layout.autoroute(pcb_in, pcb_out, passes=20)
= dsn_export (pcbnew python in the KiCad flatpak:
pcbnew.ExportSpecctraDSN — headless, verified 10.0)
→ route (.tools/freerouting-2.2.4-linux-x64/bin/freerouting,
BUNDLED JRE — no system java; classic CLI
-de in.dsn -do out.ses -mp N -da)
→ ses_import (pcbnew.ImportSpecctraSES + SaveBoard)
Returns segment/via counts. Bootstrap if .tools missing: download freerouting-X-linux-x64.zip from github freerouting/freerouting releases, unzip into .tools/ (no root needed).
Preconditions (or DSN export is meaningless)
- Edge.Cuts outline present (closed).
- Pads carry nets. Update-PCB-from-Schematic normally fills them; when
building boards programmatically, append
(net "NAME")to each pad — pcb format 20260206 (KiCad 10) keys nets BY NAME, no numeric id (old(net 1 "N1")style is normalized on import, harmless). - Placement matters more than the router: group by schematic function, decoupling caps adjacent, connectors at edges (rule canon).
After routing — never skip
kicad-cli pcb drc --severity-allset-diff vs pre-route baseline.- Render F.Cu/B.Cu/Edge.Cuts → PNG → look (kicad-review pixel diff).
- pcbnew rewrites the file wholesale on SES import — commit the pre-route board first, diff after.
- Board OPEN in the user's editor? Don't write the file (refused while
the lock exists): apply placement live with
kx live pcb place FILEandkx live pcb refill(kicad-pcb skill, "Live mode"); route on a saved copy, then hand back.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |