Skip to content

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

datasheets

Verified

Extract structured specifications from electronic component datasheet PDFs — pinouts, electrical characteristics, peripherals, topology, and features. Cache extractions per project for consumption by schematic and PCB analyzers. Primary consumer infrastructure for `kicad`, `emc`, `spice`, and `thermal` analyzers. Use this skill whenever the user asks to extract, verify, or read specs from a component datasheet; when analyzers need verified IC knowledge (EN pin thresholds, PG presence, USB peripheral speed); or when a review mentions datasheet coverage, extraction quality, or per-MPN specifications. Also triggers on "extract this datasheet", "what are the specs for MPN X", "verify datasheet extraction", or "check pin functions for part Y".

FileKindSize
SKILL.mdskill md11.2 KB
datasheet_types/__init__.pyscript1.9 KB
datasheet_types/base_block.pyscript6.5 KB
datasheet_types/cache_reader.pyscript12.3 KB
datasheet_types/codec.pyscript6.3 KB
datasheet_types/extraction.pyscript8.0 KB
datasheet_types/pinout.pyscript5.2 KB
datasheet_types/regulator.pyscript5.3 KB
datasheet_types/spec_value.pyscript2.4 KB
datasheet_types/trust_gating.pyscript5.0 KB
distributor_core/__init__.pyscript0 B
distributor_core/cli.pyscript2.9 KB
distributor_core/download.pyscript36.7 KB
distributor_core/inputs.pyscript9.0 KB
distributor_core/manifest.pyscript5.7 KB
distributor_core/sync.pyscript21.0 KB
distributor_core/verify.pyscript12.1 KB
examples/abm8g-106-12.000mhz-t.jsonconfig9.4 KB
examples/irlml6344.jsonconfig16.0 KB
examples/lm2596-adj.jsonconfig14.3 KB
examples/lm358.jsonconfig15.6 KB
examples/mbrs540t3g.jsonconfig12.3 KB
examples/stm32f103c8t6.jsonconfig51.1 KB
prompts/base.mdmarkdown4.5 KB
prompts/crystal.mdmarkdown8.8 KB
prompts/diode.mdmarkdown8.3 KB
prompts/mcu.mdmarkdown9.6 KB
prompts/opamp.mdmarkdown10.7 KB
prompts/pinout.mdmarkdown4.7 KB
prompts/regulator.mdmarkdown4.4 KB
prompts/scout.mdmarkdown3.5 KB
prompts/transistor.mdmarkdown12.5 KB
references/cache-layout.mdmarkdown8.4 KB
references/consumer-api.mdmarkdown10.8 KB
references/dispatch-claude-code.mdmarkdown9.4 KB
references/dispatcher-contract.mdmarkdown8.2 KB
references/extraction-pipeline.mdmarkdown1.7 KB
references/extraction-schema.mdmarkdown18.0 KB
references/field-extraction-guide.mdmarkdown14.9 KB
references/quality-scoring.mdmarkdown8.4 KB
schemas/CHANGELOG.mdmarkdown16.0 KB
schemas/base.schema.jsonconfig9.3 KB
schemas/crystal.schema.jsonconfig7.2 KB
schemas/diode.schema.jsonconfig7.9 KB
schemas/extraction.schema.jsonconfig3.7 KB
schemas/fixtures/lm2596-adj.example.jsonconfig14.3 KB
schemas/fixtures/manifest.example.jsonconfig1000 B
schemas/fixtures/minimal.example.jsonconfig2.1 KB
schemas/manifest.schema.jsonconfig3.0 KB
schemas/mcu.schema.jsonconfig12.4 KB
schemas/opamp.schema.jsonconfig9.2 KB
schemas/pinout.schema.jsonconfig5.9 KB
schemas/plan.schema.jsonconfig4.6 KB
schemas/regulator.schema.jsonconfig8.4 KB
schemas/scout.schema.jsonconfig2.9 KB
schemas/spec_value.schema.jsonconfig3.0 KB
schemas/transistor.schema.jsonconfig12.0 KB
scripts/_smoke_v14_roundtrip.pyscript8.9 KB
scripts/datasheet_extract_cache.pyscript21.2 KB
scripts/datasheet_features.pyscript17.1 KB
scripts/datasheet_page_selector.pyscript16.7 KB
scripts/datasheet_score.pyscript15.5 KB
scripts/datasheet_verify.pyscript45.6 KB
scripts/extraction_schema.pyscript1.8 KB
scripts/merge_results.pyscript13.0 KB
scripts/plan_extraction.pyscript9.5 KB
scripts/validate_extraction_result.pyscript4.0 KB
scripts/validate_sanity_vector.pyscript6.4 KB

schemas/crystal.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://kicad-happy.local/datasheets/schemas/crystal.schema.json",
  "title": "CrystalExtension",
  "description": "Category extension for crystals and resonators (AT-cut quartz, ceramic resonators, TCXO, VCXO, OCXO). Layered on top of base per spec §7. Version 1.0. Field union from ABM8G-106-12.000MHZ-T (Abracon 12 MHz AT-cut SMD crystal, 3.2×2.5×1.0 mm). Only one full extraction has been checked against this schema; TCXO/VCXO/OCXO variants have no fixtures yet.",
  "x-schema-version": "1.0",
  "type": "object",
  "required": ["crystal_type"],
  "additionalProperties": false,
  "properties": {
    "crystal_type": {
      "type": "string",
      "enum": ["at_cut", "ceramic_resonator", "tcxo", "vcxo", "ocxo"],
      "description": "Crystal or resonator type. at_cut: standard AT-cut quartz (most common for MHz-range consumer parts). ceramic_resonator: ceramic resonator (lower Q, wider tolerance, cheaper). tcxo: temperature-compensated crystal oscillator (integrated oscillator circuit). vcxo: voltage-controlled crystal oscillator. ocxo: oven-controlled crystal oscillator (highest stability)."
    },
    "frequency": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Nominal resonant frequency in Hz. Store MHz as Hz (e.g. 12 MHz → 12000000). Store kHz as Hz (e.g. 32.768 kHz → 32768). Evidence from cover page or frequency table."
    },
    "frequency_tolerance": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Initial frequency tolerance at +25°C in ppm (unit: 'ppm'). Symmetric tolerance stored as min/max (e.g. ±20 ppm → min=-20, max=20). Condition should note the reference temperature."
    },
    "frequency_stability": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Frequency stability over the operating temperature range in ppm (unit: 'ppm'), referenced to +25°C. Stored as min/max symmetric envelope. Condition specifies the temperature range."
    },
    "aging": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Long-term frequency aging drift in ppm (unit: 'ppm'). Condition should note the time window (e.g. 'first year'). Stored as min/max symmetric envelope (e.g. ±3 ppm/year → min=-3, max=3). Most datasheets specify aging only for the first year."
    },
    "load_capacitance": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Specified load capacitance in Farads (unit: 'F'). Store pF as F (e.g. 12 pF → 1.2e-11, 18 pF → 1.8e-11). This is the capacitance the oscillator circuit must present to the crystal to achieve the nominal frequency. Common values: 8 pF, 10 pF, 12 pF, 18 pF, 20 pF."
    },
    "motional_capacitance": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Motional (series) capacitance C1 of the Butterworth–Van Dyke equivalent circuit in Farads (unit: 'F'). Typically 1–3 fF for AT-cut crystals (e.g. 2 fF → 2e-15). Published only for AT-cut quartz; ceramic resonators, TCXO, VCXO, OCXO rarely publish this parameter. Set null when not on the datasheet."
    },
    "motional_inductance": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Motional inductance L1 of the Butterworth–Van Dyke equivalent circuit in Henries (unit: 'H'). Typically millihenry to henry range for AT-cut crystals. Published only for AT-cut quartz; ceramic resonators, TCXO, VCXO, OCXO rarely publish this parameter. Set null when not on the datasheet."
    },
    "esr_max": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Maximum equivalent series resistance (ESR or R1) in Ohms (unit: 'Ω'). This is a maximum spec — use the max field. Condition may specify frequency and load capacitance. Higher ESR parts require higher oscillator gain."
    },
    "drive_level_max": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Maximum allowable crystal excitation power in Watts (unit: 'W'). Store µW as W (e.g. 100 µW → 1e-4). This is a maximum spec — use the max field. Exceeding drive level causes aging acceleration and frequency deviation."
    },
    "operating_temp_range": {
      "type": ["array", "null"],
      "items": {"$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json"},
      "description": "Operating temperature range in degrees Celsius (unit: '°C'). Stored as min/max. Common grades: commercial (0 to +70°C), industrial (-40 to +85°C), automotive (-40 to +125°C)."
    },
    "mode": {
      "type": ["string", "null"],
      "enum": ["fundamental", "overtone_3rd", "overtone_5th", null],
      "description": "Resonance mode of operation. fundamental: first overtone (most common for consumer crystals ≤30 MHz). overtone_3rd: third overtone (used for 30–100 MHz range). overtone_5th: fifth overtone (used for higher frequencies). null for ceramic resonators (which operate at fundamental but don't publish this term explicitly), TCXO, VCXO, OCXO (which integrate the oscillator circuit)."
    },
    "package": {
      "type": ["object", "null"],
      "additionalProperties": false,
      "description": "Package physical characteristics. body_mm uses nested object shape (nested-object convention — inner keys align with base.schema.json body_mm shape).",
      "required": ["evidence"],
      "properties": {
        "code": {
          "type": ["string", "null"],
          "description": "Datasheet package code (e.g. 'SMD-3225', 'SMD-2016', 'HC-49/US', 'SMD-5032'). 3225 = 3.2×2.5 mm, 2016 = 2.0×1.6 mm, etc."
        },
        "body_mm": {
          "type": ["object", "null"],
          "additionalProperties": false,
          "description": "Package body dimensions in millimeters. Nested object using the nested-object convention. Inner keys (length/width/height) align with base.schema.json's body_mm shape.",
          "properties": {
            "length": {
              "type": "number",
              "description": "Body length in millimeters along the longest plan-view axis."
            },
            "width": {
              "type": "number",
              "description": "Body width in millimeters along the perpendicular-to-length axis."
            },
            "height": {
              "type": "number",
              "description": "Body height in millimeters (package thickness / standoff direction)."
            }
          }
        },
        "evidence": {
          "$ref": "https://kicad-happy.local/datasheets/schemas/spec_value.schema.json#/properties/evidence"
        }
      }
    }
  }
}
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: 198kUpdated Claude CodeCodexVerifiedInstall