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/instances.py

View on GitHub
"""Which instance data KiCad 10 uses for a placed symbol on one sheet path.

A placed symbol carries one instance (reference, unit) per sheet path it appears on.  KiCad
looks the sheet's full path up exactly (the root sheet uuid first, then the sheet uuids); with
no instance for that path it copies the first instance of the current project, else the first
instance (``SCH_SHEET_PATH::CheckForMissingSymbolInstances``).
"""
from __future__ import annotations

from kicad_core.fields import MANDATORY_STRIP
from kicad_core.sexp import find_first, get_value


def tilde_is_empty(file_version) -> bool:
    """True when a ``"~"`` field text means empty: files older than 20250318 (unreadable
    versions count as old)."""
    try:
        return int(file_version) < 20250318
    except (TypeError, ValueError):
        return True


def _norm_path(path: str) -> str:
    return path.rstrip("/").lower()


def resolve_instance(candidates: list[dict], instance_path: str,
                     project_name: str) -> dict | None:
    """Pick the instance KiCad uses on *instance_path*.

    *candidates* are dicts with ``path`` (full KIID path), ``project``, ``reference`` and
    ``unit``, in load order.  An exact path match wins, the last duplicate replacing earlier
    ones; otherwise the first candidate of *project_name*, else the first candidate; None when
    there are no candidates (the caller keeps the Reference field).
    """
    want = _norm_path(instance_path)
    hit = None
    for cand in candidates:
        if _norm_path(cand.get("path") or "") == want:
            hit = cand
    if hit is not None or not candidates:
        return hit
    for cand in candidates:
        if cand.get("project") == project_name:
            return cand
    return candidates[0]


def inline_instances(sym: list, tilde_empty: bool) -> list[dict]:
    """The ``(instances (project P (path X ...)))`` entries of a placed symbol, in file order.

    Each entry has ``project``, ``path``, ``reference`` and ``unit`` (None when absent), plus
    ``value`` / ``footprint`` when the path carries them.
    """
    out = []
    node = find_first(sym, "instances")
    if not node:
        return out
    for proj in node[1:]:
        if not isinstance(proj, list) or len(proj) < 2 or proj[0] != "project":
            continue
        for path_node in proj[2:]:
            if not isinstance(path_node, list) or not path_node or path_node[0] != "path":
                continue
            try:
                unit = int(get_value(path_node, "unit") or 0) or None
            except (TypeError, ValueError):
                unit = None
            entry = {"project": proj[1] if isinstance(proj[1], str) else "",
                     "path": path_node[1] if len(path_node) > 1 else "",
                     "reference": get_value(path_node, "reference") or "",
                     "unit": unit}
            for key in ("value", "footprint"):
                text = get_value(path_node, key)
                if text is not None:
                    entry[key] = ("" if (tilde_empty and text == "~") else text).strip(MANDATORY_STRIP)
            variants = variant_blocks(path_node)
            if variants:
                entry["variants"] = variants
            out.append(entry)
    return out


_VARIANT_FLAGS = ("dnp", "in_bom", "on_board", "exclude_from_sim")
# Before this file version KiCad stored a variant's in_bom with the inverted meaning.
_VARIANT_IN_BOM_FIXED = 20260306


def variant_blocks(path_node: list) -> dict:
    """The ``(variant (name N) ...)`` blocks of one instance path, by name (a later block of a
    name replaces an earlier one): each flag token as written ("yes" / "no") and ``fields``
    (name -> text, as written)."""
    out = {}
    for node in path_node:
        if not isinstance(node, list) or not node or node[0] != "variant":
            continue
        block = {"fields": {}}
        for child in node[1:]:
            if not isinstance(child, list) or len(child) < 2:
                continue
            if child[0] == "name":
                block["name"] = str(child[1])
            elif child[0] in _VARIANT_FLAGS:
                block[child[0]] = str(child[1])
            elif child[0] == "field":
                name = get_value(child, "name")
                if name is not None:
                    block["fields"][name] = get_value(child, "value") or ""
        out[block.pop("name", "")] = block
    return out


def variant_overrides(variants: dict | None, name: str | None, file_version) -> dict:
    """What design variant *name* changes on one symbol or sheet instance, as KiCad 10 reads it:
    each of dnp / in_bom / on_board / exclude_from_sim the variant sets (a bool), and
    ``fields`` (name -> text).  Empty when *name* is None or the instance has no such variant
    (the default variant: the symbol's own attributes and fields)."""
    block = (variants or {}).get(name) if name is not None else None
    if not block:
        return {}
    out = {flag: block[flag] == "yes" for flag in _VARIANT_FLAGS if flag in block}
    if "in_bom" in out:
        try:
            fixed = int(file_version) >= _VARIANT_IN_BOM_FIXED
        except (TypeError, ValueError):
            fixed = False
        if not fixed:
            out["in_bom"] = not out["in_bom"]
    if block["fields"]:
        out["fields"] = dict(block["fields"])
    return out


def instance_variants(node: list, path: str) -> dict | None:
    """The variant blocks of the instance of a sheet (or symbol) *node* whose path is exactly
    *path*; the last such instance wins.  None when there is none."""
    want = _norm_path(path)
    hit = None
    for entry in inline_instances(node, False):
        if _norm_path(entry["path"]) == want:
            hit = entry
    return hit.get("variants") if hit else None
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated 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