akcli-circuit-designlisted
Install: claude install-skill tipoLi5890/akcli
# akcli-circuit-design — driving `akcli` for schematic read / analyze / diff / draw
`akcli` is a zero-dependency Python ≥3.11 CLI that reads
**Altium binary** `.SchDoc` / `.SchLib` / `.PcbDoc` and **KiCad** `.kicad_sch` / `.kicad_sym` /
`.kicad_pcb` into one normalized model, runs design checks, diffs revisions, and writes KiCad
schematics from an op-list — with **no Altium or KiCad installed**. It is **not** an
Altium-to-KiCad converter.
When the plugin is installed, `akcli` is on `PATH`. Run it with the `Bash` tool. From a raw
checkout instead use `PYTHONPATH=src python3 -m akcli ...` or `bin/akcli ...`.
## Core design principles (follow these — they are why this tool exists)
- **Raw data only at the source; derive everything yourself, downstream.** Readers emit a
normalized model (components, pins, nets, primitives); checks/diff/pinmap compute on top of it.
- **Never trust a single tool blindly.** The original Altium net merge had a real bug (split
same-name `GND`, dropped a `STAT`↔`LED1_GPIO_RD` alias). Always **verify converted/derived
results**: re-read after writing, cross-check a netlist against an expected table, and treat
any vacuous "0 findings" with suspicion (read the metadata caveats `check` prints — passive-pin
ratio, No-ERC suppressed count, unnamed-net count).
- **Altium is read/analyze-only.** `akcli` never writes Altium files offline. KiCad gets a full
cross-platform writer (`plan`/`draw`). For Altium edits, deliver human draw instructions p