# KiCad Board Audit

An agent skill that turns "review this board for errors" into a repeatable,
verified audit of any KiCad project, schematic and layout, before you spend
money on fabrication.

## What it does

1. **Runs the real checkers**: `kicad-cli` ERC + DRC (locally or through the
   Adom desktop KiCad bridge), and reads the project's silenced-rule config so
   a "clean" pass can't hide muted checks.
2. **Extracts the pad-level netlist** from the `.kicad_pcb` (the synced ground
   truth) with the bundled `assets/kicad_netlist.py`: components, per-net pin
   lists, unconnected pads, routed lengths, via counts. Handles KiCad 7–10
   format differences.
3. **Walks an electrical checklist** for the bugs ERC is structurally blind to:
   floating mandatory pins (VCAP-type), supply pins tied to GND, strap/boot-pin
   encodings, regulator dividers computed with the wrong variant's VFB, missing
   open-drain pull-ups, crystal load-cap math, connector shields, reset timing.
4. **Audits the layout from the file**: net-class impedance assignment (and
   nets that silently fall into Default), diff-pair skew, via-vs-constraint
   conflicts, keepout allow-flags, stale zones, unrouted items.
5. **Verifies every suspicion against a primary source** (datasheet, vendor
   hardware-design checklist, EVB schematic) before reporting it, then delivers
   a severity-ranked report (Critical / High / Medium / Low), each finding
   with refs, pins, evidence, and a concrete fix, plus a verified-correct
   section so good design doesn't get re-flagged next review.

Born from a real audit of a 7-port automotive Ethernet switch board where ERC
reported 0/0 while the MCU's VCAP pins floated and four switch supply pins sat
on GND. The checklist is generic: it applies to any board with ICs on it.

## Install

```bash
adom-wiki pkg install adom/kicad-board-audit
```

The install links the skill into `~/.claude/skills/` so any agent session can
invoke it. Then just ask: *"audit this board: path/to/project.kicad_pro"*.