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

View on GitHub
"""KiCad text variable expansion (``${NAME}``), as KiCad 10 expands field text.

A port of ``ExpandTextVars`` / ``ResolveTextVars`` (common/common.cpp): nested ``${}`` expand
innermost first; ``\\${…}`` and ``\\@{…}`` are escapes, kept literal and shown as ``${…}`` /
``@{…}``; a token the resolver does not know stays ``${TOKEN}``; ``${}`` is dropped;
``ERC_*`` / ``DRC_*`` tokens are dropped outside ERC/DRC; ``@{…}`` math has its variables
expanded but is not evaluated.  Expansion repeats while text variables remain, up to KiCad's
default recursion depth of 6 and while the text stays within 64 KiB (or its own length, if
longer): a variable that holds its own token would otherwise grow without bound.
"""
from __future__ import annotations

from typing import Callable

from .diagnostics import record

MAX_DEPTH = 6
MAX_TEXT_LEN = 1 << 16
_warned = False


class _TooLong(Exception):
    pass

_ESC_DOLLAR = "<<<ESC_DOLLAR:"
_ESC_AT = "<<<ESC_AT:"
_ERC_DRC = ("ERC_WARNING", "ERC_ERROR", "DRC_WARNING", "DRC_ERROR")


def _copy_marker(src: str, i: int, marker: str, out: list) -> int:
    """Copy an escape marker and its contents up to the matching ``}``; return the next index."""
    out.append(marker)
    i += len(marker)
    count = 1
    while i < len(src) and count > 0:
        c = src[i]
        if c == "{":
            count += 1
        elif c == "}":
            count -= 1
        out.append(c)
        i += 1
    return i


def _has_vars(text: str) -> bool:
    return "${" in text or "@{" in text


def _expand_once(src: str, resolve: Callable[[str], str | None], depth: int = 0) -> str:
    """One pass of KiCad's ExpandTextVars."""
    out: list = []
    n = len(src)
    limit = max(MAX_TEXT_LEN, n)
    size = 0  # characters appended to out so far
    i = 0
    while i < n:
        if src.startswith(_ESC_DOLLAR, i):
            j = _copy_marker(src, i, _ESC_DOLLAR, out)
            size += j - i
            i = j
            continue
        if src.startswith(_ESC_AT, i):
            j = _copy_marker(src, i, _ESC_AT, out)
            size += j - i
            i = j
            continue
        c = src[i]
        if c == "\\" and i + 2 < n and src[i + 1] in "$@" and src[i + 2] == "{":
            out.append(_ESC_DOLLAR if src[i + 1] == "$" else _ESC_AT)
            j = i + 3
            count = 1
            while j < n and count > 0:
                if src[j] == "{":
                    count += 1
                elif src[j] == "}":
                    count -= 1
                out.append(src[j])
                j += 1
            size += len(_ESC_DOLLAR) + j - i - 3
            i = j
            continue
        if c in "$@" and i + 1 < n and src[i + 1] == "{":
            is_math = c == "@"
            token: list = []
            count = 1
            j = i + 2
            while j < n:
                if src.startswith(_ESC_DOLLAR, j):
                    j = _copy_marker(src, j, _ESC_DOLLAR, token)
                    continue
                if src.startswith(_ESC_AT, j):
                    j = _copy_marker(src, j, _ESC_AT, token)
                    continue
                ch = src[j]
                if ch == "{":
                    count += 1
                elif ch == "}":
                    count -= 1
                    if count == 0:
                        break
                token.append(ch)
                j += 1
            i = j + 1
            tok = "".join(token)
            if not tok:
                continue
            if _has_vars(tok) and depth < MAX_DEPTH:
                tok = _expand_once(tok, resolve, depth + 1)
            if is_math:
                out.append("@{" + tok + "}")
                size += len(tok) + 3
            elif tok.startswith(_ERC_DRC):
                pass
            else:
                value = resolve(tok)
                value = value if value is not None else "${" + tok + "}"
                out.append(value)
                size += len(value)
            if size > limit:
                raise _TooLong
            continue
        out.append(c)
        size += 1
        i += 1
    return "".join(out)


def resolve_text_vars(text: str, resolve_at: Callable[[str, int], str | None],
                      depth: int = 0) -> str:
    """KiCad's multi-pass ResolveTextVars.  *resolve_at(token, depth)* receives the pass's
    depth so a resolver that expands further text can carry it on; the result keeps the
    escape markers (see unescape_text_vars)."""
    while _has_vars(text):
        depth += 1
        if depth > MAX_DEPTH:
            break
        d = depth
        try:
            text = _expand_once(text, lambda tok: resolve_at(tok, d))
        except _TooLong:
            global _warned
            if not _warned:
                _warned = True
                record(None, "textvars", ValueError(
                    f"text variable expansion passed {MAX_TEXT_LEN} characters"),
                    "expansion stopped")
            break
    return text


def unescape_text_vars(text: str) -> str:
    """Turn escape markers back into literal ``${`` / ``@{`` (done once, on the shown text)."""
    return text.replace(_ESC_DOLLAR, "${").replace(_ESC_AT, "@{")


def expand_text_vars(text: str, resolve: Callable[[str], str | None]) -> str:
    """*text* with every ``${TOKEN}`` that *resolve* knows replaced; unknown tokens stay as
    written and ``\\${`` is a literal ``${``."""
    if _has_vars(text):
        text = resolve_text_vars(text, lambda tok, _depth: resolve(tok))
    return unescape_text_vars(text)
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