Skip to content

hashgraph-online/awesome-codex-plugins / plugins/aklofas/kicad-happy/skills/kicad

Analyze KiCad projects and PDF schematics: schematics, PCB layouts, Gerbers, footprints, symbols, netlists, and design rules. Reviews designs for bugs, traces nets, cross-references schematic to PCB, extracts BOM data, checks DRC/ERC, DFM, power trees, and regulator circuits. Every finding carries a confidence label and evidence source with trust_summary rollup. Analyzes PDF schematics from dev boards, reference designs, eval kits, and datasheets. Supports KiCad 5–10. Use whenever the user mentions .kicad_sch, .kicad_pcb, .kicad_pro, PCB design review, schematic analysis, PDF schematics, reference designs, Gerber files, DRC/ERC, netlist issues, BOM extraction, signal tracing, power budget, DFM, or wants to understand, debug, compare, or review any hardware design. Also for "check my board", "review before fab", "what's wrong with my schematic", "is this ready to order", "check my power supply", "verify this circuit", OSHWA certification readiness, or any electronics/PCB design question.

FileKindSize
SKILL.mdskill md79.1 KB
references/config-reference.mdmarkdown19.1 KB
references/datasheet-verification.mdmarkdown16.5 KB
references/deep-review.mdmarkdown9.7 KB
references/design-intent.mdmarkdown5.6 KB
references/diff-analysis.mdmarkdown17.6 KB
references/file-formats.mdmarkdown15.1 KB
references/gerber-parsing.mdmarkdown33.5 KB
references/manual-gerber-parsing.mdmarkdown24.5 KB
references/manual-pcb-parsing.mdmarkdown17.2 KB
references/manual-schematic-parsing.mdmarkdown12.8 KB
references/net-tracing.mdmarkdown12.0 KB
references/oshwa-certification.mdmarkdown4.5 KB
references/output-schema.mdmarkdown33.4 KB
references/pcb-layout-analysis.mdmarkdown27.3 KB
references/pdf-schematic-extraction.mdmarkdown15.2 KB
references/report-generation.mdmarkdown56.3 KB
references/schematic-analysis.mdmarkdown63.9 KB
references/standards-compliance.mdmarkdown33.5 KB
references/supplementary-data-sources.mdmarkdown12.5 KB
references/what-if.mdmarkdown19.5 KB
review/README.mdmarkdown4.1 KB
review/fixtures/deep_review.example.jsonconfig1.2 KB
review/fixtures/design_context.example.jsonconfig388 B
review/fixtures/review_annotations.example.jsonconfig707 B
review/prompts/design_context.mdmarkdown4.9 KB
review/schemas/deep_review.schema.jsonconfig3.3 KB
review/schemas/design_context.schema.jsonconfig2.2 KB
review/schemas/review_annotations.schema.jsonconfig1.9 KB
review/scripts/_mini_jsonschema.pyscript6.6 KB
review/scripts/build_review_plan.pyscript2.3 KB
review/scripts/deep_review_gate.pyscript27.3 KB
review/scripts/merge_annotations.pyscript7.0 KB
review/scripts/validate_review.pyscript2.6 KB
scripts/.gitignoreother13 B
scripts/README.mdmarkdown23.4 KB
scripts/analysis_cache.pyscript42.1 KB
scripts/analyze_gerbers.pyscript90.9 KB
scripts/analyze_pcb.pyscript7.4 KB
scripts/analyze_schematic.pyscript6.7 KB
scripts/analyze_thermal.pyscript48.5 KB
scripts/analyzer_envelope.pyscript15.5 KB
scripts/capability_mode.pyscript10.2 KB
scripts/check_report_sections.pyscript10.6 KB
scripts/cross_analysis.pyscript69.4 KB
scripts/cross_verify.pyscript23.1 KB
scripts/design_intent.pyscript13.5 KB
scripts/detection_schema.pyscript26.0 KB
scripts/detector_helpers.pyscript15.2 KB
scripts/diff_analysis.pyscript23.5 KB
scripts/diff_engine.pyscript47.2 KB
scripts/domain_detectors.pyscript260.5 KB
scripts/envelopes/__init__.pyscript0 B
scripts/envelopes/cross_analysis.pyscript5.9 KB
scripts/envelopes/gerber.pyscript16.1 KB
scripts/envelopes/pcb.pyscript25.9 KB
scripts/envelopes/schematic.pyscript23.1 KB
scripts/envelopes/thermal.pyscript7.4 KB
scripts/export_issues.pyscript27.6 KB
scripts/fab_release_gate.pyscript29.8 KB
scripts/finding_schema.pyscript25.7 KB
scripts/gen_output_schema_md.pyscript9.2 KB
scripts/inputs_builder.pyscript4.0 KB
scripts/kicad_core/__init__.pyscript0 B
scripts/kicad_core/classify.pyscript32.5 KB
scripts/kicad_core/cli.pyscript4.2 KB
scripts/kicad_core/coords.pyscript2.0 KB
scripts/kicad_core/diagnostics.pyscript1.9 KB
scripts/kicad_core/executables.pyscript1.0 KB
scripts/kicad_core/fields.pyscript5.9 KB
scripts/kicad_core/fileio.pyscript5.4 KB
scripts/kicad_core/hotloop.pyscript3.1 KB
scripts/kicad_core/instances.pyscript5.7 KB
scripts/kicad_core/model.pyscript4.8 KB
scripts/kicad_core/netnames.pyscript19.1 KB
scripts/kicad_core/netquery.pyscript6.7 KB
scripts/kicad_core/pairing.pyscript1.9 KB
scripts/kicad_core/parts.pyscript28.9 KB
scripts/kicad_core/passives.pyscript10.0 KB
scripts/kicad_core/pdn.pyscript1011 B
scripts/kicad_core/project.pyscript43.2 KB
scripts/kicad_core/render.pyscript2.7 KB
scripts/kicad_core/sexp.pyscript12.6 KB
scripts/kicad_core/textvars.pyscript5.4 KB
scripts/kicad_core/token_cache.pyscript2.2 KB
scripts/kicad_core/values.pyscript14.1 KB
scripts/kicad_types.pyscript15.1 KB
scripts/lifecycle_audit.pyscript6.7 KB
scripts/lifecycle_engine.pyscript52.8 KB
scripts/lookup_detectors.pyscript29.9 KB
scripts/lookup_helpers.pyscript3.0 KB
scripts/methodology_gerbers.mdmarkdown23.1 KB
scripts/methodology_pcb.mdmarkdown22.2 KB
scripts/methodology_schematic.mdmarkdown43.1 KB
scripts/netlist_queries.pyscript4.2 KB
scripts/output_filters.pyscript16.8 KB
scripts/output_io.pyscript5.3 KB
scripts/pcb/__init__.pyscript0 B
scripts/pcb/assembly.pyscript58.3 KB
scripts/pcb/connectivity.pyscript27.7 KB
scripts/pcb/copper.pyscript61.0 KB
scripts/pcb/dfm.pyscript56.9 KB
scripts/pcb/geometry.pyscript59.5 KB
scripts/pcb/pipeline.pyscript30.3 KB
scripts/pcb/presentation.pyscript24.3 KB
scripts/pcb/reader.pyscript87.1 KB
scripts/pcb/routing.pyscript53.5 KB
scripts/project_config.pyscript23.1 KB
scripts/risk_summary.pyscript3.1 KB
scripts/run_id.pyscript1.7 KB
scripts/schema_codec.pyscript5.0 KB
scripts/schematic/__init__.pyscript0 B
scripts/schematic/audits.pyscript56.0 KB
scripts/schematic/bom_stats.pyscript6.1 KB
scripts/schematic/connectivity.pyscript62.9 KB
scripts/schematic/erc_pins.pyscript8.4 KB
scripts/schematic/hierarchy.pyscript21.5 KB
scripts/schematic/ic_analysis.pyscript21.4 KB
scripts/schematic/legacy_reader.pyscript49.4 KB
scripts/schematic/net_analysis.pyscript75.5 KB
scripts/schematic/pipeline.pyscript72.2 KB
scripts/schematic/presentation.pyscript20.9 KB
scripts/schematic/reader.pyscript64.7 KB
scripts/schematic/system_analyses.pyscript126.9 KB
scripts/signal_detectors.pyscript248.0 KB
scripts/summarize_findings.pyexecutablescript17.4 KB
scripts/validation_detectors.pyscript75.3 KB
scripts/what_if.pyscript68.4 KB

scripts/kicad_core/netquery.py

View on GitHub
"""Pin/net index primitives (kicad_core): the net-id map helper, the pin and reference index builders, and the bridge facts (BridgeFact, BridgeFacts, build_bridge_facts) and the net-tie conductors (tie_conductors, conductor_of)."""

from collections import Counter
from dataclasses import dataclass

from kicad_core.model import Net, PinNetEntry
from kicad_core.values import parse_value


def build_pin_to_net_map(nets: dict[str, Net]) -> dict[tuple[str, str], PinNetEntry]:
    """Build a reverse map: (component, pin_number) -> (net_name, net_info)."""
    pin_net = {}
    for net_name, net_info in nets.items():
        for p in net_info["pins"]:
            pin_net[(p["component"], p["pin_number"])] = (net_name, net_info)
    return pin_net


def build_net_id_map(pcb):
    """Return {net_id (int): net_name (str)} from PCB JSON.

    Handles both the current flat form pcb['nets'] = {"6": "GND", ...}
    and the legacy nested form pcb['nets']['net_info'] = [{"id": 6, ...}, ...].
    """
    nets = pcb.get('nets', {})
    out = {}
    if isinstance(nets, dict):
        for k, v in nets.items():
            if isinstance(v, str):
                try:
                    out[int(k)] = v
                except (ValueError, TypeError):
                    continue
        if out:
            return out
        for ni in nets.get('net_info', []) or []:
            try:
                out[int(ni.get('id', -1))] = ni.get('name', '')
            except (ValueError, TypeError):
                continue
    return out


def build_ref_pins(nets: dict) -> dict[str, list[tuple[str, str, str]]]:
    """ref -> [(pin_number, net_name, pin_type)] in net-map order.

    This is the per-ref hop table the PP-001 walk uses; the order is the order
    ``build_net_map`` emitted the nets and their pins, which the walk depends on.
    """
    ref_pins: dict[str, list[tuple[str, str, str]]] = {}
    for net_name, net_info in nets.items():
        for p in net_info.get("pins", []):
            ref = p.get("component") or ""
            if not ref:
                continue
            ref_pins.setdefault(ref, []).append(
                (str(p.get("pin_number", "")), net_name,
                 str(p.get("pin_type", ""))))
    return ref_pins


@dataclass(frozen=True)
class BridgeFact:
    """What is known about one DC-bridge-capable component.

    ref:           component reference
    nets:          endpoint nets in net-map order (jumper detections: the detection's ``nets``)
    kind:          "jumper" | "resistor" | "inductor" | "ferrite_bead" | "fuse" | "net_tie"
    default_state: jumpers: the detection's ``default_state`` ("bridged" / "open" / other), else None
    resistance:    resistors: parsed ohms, 0.0 for a bare zero-ohm spelling, None when unparsable; else None
    """
    ref: str
    nets: tuple[str, ...]
    kind: str
    default_state: str | None
    resistance: float | None


@dataclass(frozen=True)
class BridgeFacts:
    """Two views over the same facts. ``by_ref`` is keyed by component (the PP-001 predicate's
    input; the component's own type decides its kind). ``jumpers`` lists one fact per
    solder-jumper detection in detection order (the RS audit's input), whatever the
    component's type is."""
    by_ref: dict[str, BridgeFact]
    jumpers: list[BridgeFact]


_BRIDGE_KINDS = ("inductor", "ferrite_bead", "fuse", "resistor", "jumper", "net_tie")
_ZERO_OHM_SPELLINGS = ("0", "0r", "0ohm", "0ohms")


def build_bridge_facts(components: list[dict],
                       ref_pins: dict[str, list[tuple[str, str, str]]],
                       solder_jumpers: list[dict] | None) -> BridgeFacts:
    """Build the shared DC-bridge facts for the RS and PP audits.

    Acceptance stays with each audit: RS accepts two-net jumpers in state
    bridged/open and net ties; PP accepts inductors, ferrite beads, fuses,
    resistors <= 1 Ω, bridged jumpers and net ties. This function only records facts.
    A net tie keeps its nets apart in names, as KiCad does, but is one conductor.
    """
    detections = {}
    for sj in (solder_jumpers or []):
        detections.setdefault(sj.get("reference"), sj)
    by_ref: dict[str, BridgeFact] = {}
    ref_counts = Counter(c.get("reference") for c in components)
    for c in components:
        ref = c.get("reference") or ""
        t = (c.get("type") or c.get("category") or "").lower()
        # Two net ties sharing a reference (NT?) pool their pins in ref_pins: which nets
        # each joins is unknown, so neither joins any.
        if t == "net_tie" and ref_counts[ref] > 1:
            by_ref.pop(ref, None)
            continue
        if not ref or t not in _BRIDGE_KINDS:
            if ref:
                by_ref.pop(ref, None)   # duplicate refs: the last component wins, as the old dict did
            continue
        nets = tuple(dict.fromkeys(net for _pn, net, _pt in ref_pins.get(ref, [])))
        if t == "jumper":
            sj = detections.get(ref)
            state = sj.get("default_state") if sj else None
            if sj and sj.get("nets"):
                nets = tuple(sj.get("nets"))
            by_ref[ref] = BridgeFact(ref, nets, "jumper", state, None)
            continue
        resistance = None
        if t == "resistor":
            v = parse_value(c.get("value", ""), component_type="resistor")
            if v is None:
                val = (c.get("value") or "").strip().lower().replace(" ", "")
                resistance = 0.0 if val in _ZERO_OHM_SPELLINGS else None
            else:
                resistance = v
        by_ref[ref] = BridgeFact(ref, nets, t, None, resistance)
    jumpers = [BridgeFact(sj.get("reference", ""), tuple(sj.get("nets") or []), "jumper",
                          sj.get("default_state"), None)
               for sj in (solder_jumpers or [])]
    return BridgeFacts(by_ref, jumpers)


def tie_conductors(bridge_facts: BridgeFacts) -> dict[str, frozenset[str]]:
    """Each net a net tie touches -> every net joined to it through net ties (itself included)."""
    parent: dict[str, str] = {}

    def root(n: str) -> str:
        while parent.setdefault(n, n) != n:
            n = parent[n]
        return n

    for fact in bridge_facts.by_ref.values():
        if fact.kind == "net_tie":
            for other in fact.nets[1:]:
                a, b = root(fact.nets[0]), root(other)
                if a != b:
                    parent[max(a, b)] = min(a, b)
            if fact.nets:
                root(fact.nets[0])
    groups: dict[str, set[str]] = {}
    for n in parent:
        groups.setdefault(root(n), set()).add(n)
    return {n: frozenset(groups[root(n)]) for n in parent}


def conductor_of(ties: dict[str, frozenset[str]], net: str) -> tuple[str, ...]:
    """The nets one conductor with *net* through net ties (``tie_conductors``), sorted."""
    return tuple(sorted(ties.get(net, (net,))))
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall