Menu
Schematic design operations — create, edit, wire, net labels, export (KiCAD MCP tools 50-58)
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Full PCB verification loop using local kicad-cli (DRC + 3D render + gerbers)
Create a new Claude Code skill for this project. Use when you need to add a new skill, improve an existing skill, or convert a workflow into a reusable skill.
Verifies that every PCB pad-to-net assignment matches the manufacturer datasheet pin specifications. Use when changing board.py/routing.py/footprints.py, after GPIO remapping, before releases, or when adding new components. Automated guard against wiring errors like unconnected VBUS, wrong pin assignments, or missing GND connections.
Design intent adversary — cross-checks GPIO, nets, power chains, signal paths across firmware/schematic/PCB/datasheet sources to find lost connections and inconsistencies
Analyze a DFM report and fix all issues in the PCB generation scripts
Run DFM guard tests and add new regression tests after fixing PCB issues
| name | pcb-schematic |
| model | claude-opus-4-7 |
| description | Schematic design operations — create, edit, wire, net labels, export (KiCAD MCP tools 50-58) |
| disable-model-invocation | true |
| allowed-tools | Bash, Read, Write, Edit, Grep, Glob |
| argument-hint | ["create | edit | wire | export | info"] |
Map KiCAD MCP schematic tools to our project's programmatic schematic generation infrastructure.
The schematic is not edited manually in KiCad. It is generated programmatically via Python scripts in scripts/generate_schematics/. The master GPIO mapping lives in scripts/generate_schematics/config.py, and the generated output lands in hardware/kicad/.
cat scripts/generate_schematics/config.py
Depending on the argument:
create: Generate the full schematic from scratch:
cd /Users/pierrejonnycau/Documents/WORKS/esp32-emu-turbo && python3 -m scripts.generate_schematics hardware/kicad
edit: Modify GPIO mapping or component list in scripts/generate_schematics/config.py. Individual sheet generators live in scripts/generate_schematics/sheets/:
mcu.py -- ESP32-S3 module connectionspower_supply.py -- IP5306, AMS1117, USB-Cdisplay.py -- ILI9488 FPC-40P connectionsaudio.py -- I2S DAC, PAM8403controls.py -- D-pad, ABXY, Start/Select, L/R buttonssd_card.py -- SPI SD card interfacejoystick.py -- PSP joystick (optional)wire: Edit wiring connections in the sheet generator files under scripts/generate_schematics/sheets/. Wiring primitives are in scripts/generate_schematics/kicad_primitives.py.
export: Export schematic to PDF:
kicad-cli sch export pdf --output /tmp/schematic.pdf hardware/kicad/esp32-emu-turbo.kicad_sch
info: Show current schematic stats (component count, nets, sheets):
cd /Users/pierrejonnycau/Documents/WORKS/esp32-emu-turbo && python3 -c "
from scripts.generate_schematics import config
config._init()
print(f'GPIO pins defined: {len(config.GPIO_MAP)}')
"
Or count components in the generated schematic:
grep -c '(symbol (lib_id' hardware/kicad/esp32-emu-turbo.kicad_sch
After any changes, regenerate:
cd /Users/pierrejonnycau/Documents/WORKS/esp32-emu-turbo && python3 -m scripts.generate_schematics hardware/kicad
| File | Purpose |
|---|---|
scripts/generate_schematics/config.py | Master GPIO mapping and component configuration |
scripts/generate_schematics/__main__.py | CLI entry point for generation |
scripts/generate_schematics/__init__.py | Top-level generator orchestrator |
scripts/generate_schematics/root_schematic.py | Root schematic with sheet hierarchy |
scripts/generate_schematics/sheet_base.py | Base class for sheet generators |
scripts/generate_schematics/kicad_primitives.py | S-expression primitives for schematics |
scripts/generate_schematics/lib_symbols.py | Symbol library definitions |
scripts/generate_schematics/sheets/*.py | Individual sheet generators (mcu, power, display, audio, controls, sd_card, joystick) |
scripts/generate_pcb/primitives.py | NET_LIST definitions (shared with PCB) |
hardware/kicad/esp32-emu-turbo.kicad_sch | Generated schematic output |
| MCP Tool | Our Implementation |
|---|---|
create_schematic | python3 -m scripts.generate_schematics hardware/kicad |
load_schematic | Read hardware/kicad/esp32-emu-turbo.kicad_sch |
add_schematic_component | Edit component list in config.py + relevant sheet in sheets/ |
add_schematic_wire | Edit wiring in sheet generators under sheets/ |
add_schematic_net_label | Edit NET_LIST in scripts/generate_pcb/primitives.py |
connect_to_net | Edit routing connections in sheet generators |
export_schematic_pdf | kicad-cli sch export pdf --output /tmp/schematic.pdf hardware/kicad/esp32-emu-turbo.kicad_sch |
list_schematic_libraries | kicad-cli sym search <query> |
hardware/kicad/esp32-emu-turbo.kicad_sch directly -- it is a generated file.scripts/generate_schematics/.config.py must stay in sync with software/main/board_config.h (firmware). Use the /firmware-sync skill to verify.