Kicad Layout

Name: Kicad Layout
Author: AvatarSD

ASecurity

Autoroute 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.

5 stars
0 votes
0 copies
1 view
Added October 18, 2026

ai-agentspythonjavagitapi

Works with

Security analysis

A100/100

Scanned October 18, 2026

npx -y skills add AvatarSD/KiSkill --skill kicad-layout --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Kicad Layout?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/avatarsd-kicad-layout/badge)](https://www.skillsdirectory.com/skills/avatarsd-kicad-layout)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: kicad-layout
description: >
  Autoroute 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=<repo>; 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

1. `kicad-cli pcb drc --severity-all` set-diff vs pre-route baseline.
2. Render F.Cu/B.Cu/Edge.Cuts → PNG → look (kicad-review pixel diff).
3. 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 FILE`
  and `kx live pcb refill` (kicad-pcb skill, "Live mode"); route on a
  saved copy, then hand back.