KiSkill — agent skills for KiCad

Give your coding agent full, headless control of any KiCad project. KiSkill is a pack of Claude Code skills plus a pure-Python engine (kx) that lets an agent read, edit, verify, review, and fabricate KiCad schematics and PCBs — no GUI, no mouse, every change checked before it lands.

Built on a lossless s-expression parser (byte-identical round-trips on real 2 MB boards), a geometric verifier that runs before every write, and visual diffs fed back to the agent so it can see what it changed.

Targets KiCad 9/10 (file-based), plus LIVE board editing in an open KiCad 10 PCB editor over IPC (kx live pcb, also on a remote host via an ssh socket forward); live schematic editing rides the same adapter on KiCad 11. On KiCad 10 a GENERATED schematic updates in the operator’s open editor (kx live sch regen: save, regenerate, revert through the editor window). The core engine is stdlib-only; live mode needs kicad-python in the repo .venv (python3 -m venv .venv && .venv/bin/pip install kicad-python==0.8.0).

---

Install

Tell your agent (Claude Code, or any agent that reads ~/.claude/skills/):

Clone https://github.com/AvatarSD/KiSkill and run its install.sh to set up the KiCad skills, then verify with kx root.

Or do it yourself — one clone, one script, no pip:

git clone https://github.com/AvatarSD/KiSkill.git
cd KiSkill
./install.sh          # symlinks skills → ~/.claude/skills, kx → ~/.local/bin

install.sh is idempotent (re-run after git pull) and reversible (./install.sh --uninstall). The engine is pure Python stdlib, so there’s nothing to compile. KiCad itself (for ERC / render / fab) is resolved automatically: native kicad-cli on PATH first, then the org.kicad.KiCad flatpak, then the nightly. Override with KX_KICAD_CLI — e.g. set it to kicad-cli-nightly when you edit with the v11 nightly, so verification evidence comes from the same engine that writes your files.

Then just ask:

“Use the kicad-project skill to open ~/boards/widget/widget.kicad_pro, add a 3V3 LDO block to the schematic, and show me a diff.”

---

The skills