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

View on GitHub
"""Typed records over the reader dict shapes (kicad_core.model).

TypedDicts describe what the readers already emit, so serialisation does not
change. Open boundaries stay plain dicts: finding ``extra``
fields, manufacturer payloads, datasheet category extensions.
"""
from __future__ import annotations

from dataclasses import dataclass, field
from typing import TypedDict


class _PinRequired(TypedDict):
    number: str
    name: str
    type: str
    x: float
    y: float


class Pin(_PinRequired, total=False):
    """A placed-symbol pin as ``compute_pin_positions`` emits it (``Component['pins']``)."""
    hidden: bool
    base_name: str  # the library pin name when a placed alternate replaced it


class NetPin(TypedDict):
    """One pin connection on a net (``Net['pins']``), as ``build_net_map`` emits it."""
    component: str
    pin_number: str
    pin_name: str
    pin_type: str


class NetLabel(TypedDict):
    name: str
    type: str


class _NetRequired(TypedDict):
    name: str
    pins: list[NetPin]
    point_count: int
    no_connect: bool
    has_pwr_flag: bool
    labels: list[NetLabel]


class Net(_NetRequired, total=False):
    """A net record (``nets[key]``). ``display_name`` appears on ``/<sheet>/<name>`` collision
    keys and on ``__unnamed_N`` nets with exactly one named IC pin."""
    display_name: str


class _ComponentRequired(TypedDict):
    reference: str
    value: str
    lib_id: str
    footprint: str
    datasheet: str
    description: str
    mpn: str
    manufacturer: str
    digikey: str
    mouser: str
    lcsc: str
    element14: str
    x: float
    y: float
    angle: float
    mirror_x: bool
    mirror_y: bool
    unit: str | int | None
    uuid: str
    in_bom: bool
    dnp: bool
    on_board: bool
    pin_uuids: dict
    type: str


class Component(_ComponentRequired, total=False):
    """A placed component. Required keys are those BOTH readers (``extract_components`` and the
    legacy ``.sch`` reader) always set; everything else is optional. ``pins`` is stripped and
    ``category``/``parsed_value``/``pin_nets`` are added by result assembly; ``_sheet`` and
    ``instance_path`` (the board footprint path of the placed unit) are set by multi-sheet
    assembly; ``_unit_pins`` (a set), ``_body_style`` (the placed De Morgan body,
    default 1) and ``_dropped_values`` (earlier Value texts a later duplicate replaced, for
    the property audit) are popped before output."""
    lib_name: str
    pins: list[Pin]
    keywords: str
    functional_class: str
    is_external_connector: bool
    connector_layout: str
    transform_matrix: tuple
    category: str
    parsed_value: float
    pin_nets: dict[str, str]
    instance_path: str
    _unit_pins: set
    _body_style: int
    _sheet: int
    _power_scope: str
    _pin_source: str
    _dropped_values: list[str]


PinNetEntry = tuple[str, Net]
"""What ``AnalysisContext.pin_net`` holds: ``(net_name, net_record)`` — the record, not a pin name."""


@dataclass
class SheetData:
    """What ``parse_single_sheet`` returns for one ``.kicad_sch`` file (fields in the order the parser produces them)."""
    root: list
    components: list[Component]
    wires: list[dict]
    labels: list[dict]
    junctions: list[dict]
    no_connects: list[dict]
    sub_sheet_paths: list[tuple[str, str]]
    lib_symbols: dict
    text_annotations: list[dict]
    bus_elements: dict
    title_block: dict
    # sheet uuid -> {"fields": [(name, text)], "in_bom", "on_board", "dnp", "exclude_from_sim"}
    # for each (sheet ...) block; the sheet name and file fields are named SHEETNAME / SHEETFILE
    sheet_fields: dict = field(default_factory=dict)
    # sheet files a (sheet ...) block names that do not exist, as resolved paths
    missing_sheets: list[str] = field(default_factory=list)


@dataclass(frozen=True)
class ResolvedConfig:
    """The one resolved project configuration. Built by ``project_config.resolve_config``.

    effective:  the merged mapping consumers read (the ``config`` consumers read)
    paths:      files that contributed, in merge order (lowest precedence first); () when none
    hash_input: the single file ``inputs.config_hash`` is computed from, or None
    """
    effective: dict
    paths: tuple[str, ...]
    hash_input: str | None


@dataclass
class PcbReaderState:
    """Per-run PCB reader state: the KiCad-10 net-name → synthetic-ID map.

    Built by ``_build_net_mapping`` after extraction (sorted names, IDs from 1); consulted only by
    the backfill in ``read_board``. One instance per ``analyze_pcb()`` call — nothing module-level.
    """
    net_name_to_id: dict[str, int] = field(default_factory=lambda: {"": 0})

    def net_id(self, val: str | None) -> int:
        if not val:
            return 0
        try:
            return int(val)
        except (ValueError, TypeError):
            return self.net_name_to_id.get(val, 0)
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