Skip to content
cccskills
FreePublished on GitHub

kicad-pinmap

Pin-to-net mapping auditor -- verifies that every IC pin in the schematic is connected to the correct net, matched against a pin map source of truth (CSV, datasheet table, or Python dict). Critical for BGA/QFN devices where swap errors are invisible to DRC/ERC.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Why This Matters

ERC and DRC cannot catch a swapped pin. A power pin on a signal net passes all automated checks but produces a dead or damaged board. The only defense is comparing the schematic pin-to-net assignment against the datasheet pinout table.

Pin Map Source Format

# scripts/pin_maps.py
DEVICE_PINMAP = {
    "A1":  "GND",
    "A2":  "VDD_1V8",
    "A3":  "SPI_CLK",
    "B1":  "RESET_N",
    "C4":  "__NC__",   # explicitly no-connect
}

Sources (in priority order):

  1. Datasheet pin function table
  2. Reference design / eval board schematic
  3. Manufacturer application note

Audit Workflow

  1. Analyze the schematic with the kicad skill and retain the per-component pin/net data as analysis.json.
  2. Compare that data with the checked-in pin-map source. If the project contains a documented audit script, run it; do not assume scripts/audit_pinmap.py exists.
  3. Investigate every mismatch; it can be an intentional net alias or a defect.
  4. Decide connected/no-connect status for every unmapped pin and update the source of truth.
  5. Regenerate the schematic and repeat the audit.

Gap Filling

Unmapped pins should get no-connect markers rather than floating unconnected. Floating digital inputs can cause latch-up or undefined behavior.

Coverage Targets

Flag any IC below 80% mapped. No-connect pins count as mapped.

IC refPackageTotal pinsMappedNCCoverage
(fill in)

Common Pitfalls

SOT-23 transistors: BCE, BEC, EBC, and CBE orderings all exist for NPN BJTs; GDS, GSD, SGD for N-MOSFETs. The KiCad symbol lib_id suffix encodes an assumed pinout. Verify against the actual MPN's datasheet -- especially when no MPN is set.

Multi-unit ICs: Op-amp and gate packages with a shared VCC/GND unit. Ensure the power unit is placed and connected -- a missing power unit causes an ERC warning that can be overlooked.

Active-low signals: Verify RESET_N, CS_N, OE_N are driven with the correct polarity. A high-true signal on an active-low input means always-asserted.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Route non-critical nets on a real KiCad PCB or Specctra DSN through Circuit Weaver's fail-closed Freerouting integration. Use after placement and net-class setup when the user requests autorouting, a validated SES session, routing diagnostics, or post-route cleanup. Keep critical power, RF, clock, crystal, switching, and differential nets manual.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

bom

Free

Manage an electronics bill of materials across distributors and fabricators: part selection, stock, pricing, alternates, ordering, KiCad properties, and BOM/CPL export. Use for distributor-neutral sourcing, cost comparison, order preparation, or requests such as "what parts do I need" and "export for JLCPCB". Do not take over schematic analysis or a complete new-design workflow unless the requested task is specifically its sourcing/manufacturing stage.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

bom

Free

BOM management, sourcing, pricing, export, and fabrication preparation. Load the canonical Circuit Weaver skill from `skills/bom/SKILL.md`.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

Create, import, analyze, resume, or revise an end-to-end Circuit Weaver electronic design from requirements through validated functional KiCad schematics, placement review, and a truthful manufacturing handoff. Use for new designs and for existing KiCad/PCB/Gerber projects that need durable state. Use kicad for one-off file inspection, bom for standalone sourcing, and design-wizard only when the user explicitly requests the slower questionnaire.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

Create, import, analyze, or resume an end-to-end Circuit Weaver electronic design with durable project state. Load the canonical workflow from skills/circuit-weaver/SKILL.md. Use kicad for one-off file inspection, bom for sourcing, and design-wizard only when explicitly requested.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

Use only for an explicitly requested step-by-step Circuit Weaver questionnaire. Load the canonical workflow from skills/design-wizard/SKILL.md; use circuit-weaver for ordinary automatic new-design requests.

The English summary is being prepared. Showing the original description.

mattpainter701/kicad_automations21Updated Oct 20, 2026

See all skills by mattpainter701

Report a problem with this skill