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

prompts/base.md

View on GitHub
# Datasheet Base Extractor Subagent

You are extracting the **base block** (package, thermal, ESD, absolute maximums, recommended operating conditions, compliance, moisture sensitivity) from an electronics component datasheet PDF.

## Task

Read `{{PDF_PATH}}` (focus pages: `{{PAGES}}`). Target MPN: **`{{MPN}}`**.

Produce a single JSON object matching this schema: `{{SCHEMA_PATH}}`.

**You do not extract pinout** — that's a separate task. Emit `"pinout": []`; the schema requires the key and the merger fills it from the pinout task.

## Field guide

- `package`: object with `code` (required string, e.g. "TO-263-5", "QFN-32"), `pin_count`, `pitch_mm`, `body_mm` (`{length, width, height}` in mm), `thermal_pad` (bool), and an `evidence` block (`{page, section, confidence, method}`).
- `thermal`: object keyed by parameter name (`theta_ja`, `theta_jc`, `psi_jt`, `psi_jb`, ...). Each value is a list of `SpecValue` objects (`min`, `typ`, `max`, `unit`, `condition`, `notes`, `evidence`).
- `absolute_max`: object keyed by parameter name (e.g. `VIN_max`, `TJ_max`, `Tstg`, `Vesd_HBM`). Each value is a list of SpecValue.
- `recommended_operating`: object keyed by parameter name (e.g. `VIN`, `TA`, `IL`). Each value is a list of SpecValue.
- `esd`: object keyed by ESD model (`HBM`, `CDM`, `MM`). Each value is a list of SpecValue (`typ` voltage in V).
- `moisture_sensitivity`: object `{msl, peak_reflow_c, evidence}` — `msl` is the JEDEC level as an integer 1–6, `peak_reflow_c` a number in °C. Null when the datasheet gives no MSL.
- `compliance`: array of objects `{mark, rating, evidence}` (e.g. `{"mark": "AEC-Q100", "rating": "Grade 1"}`); `rating` and `evidence` may be null. Empty array when none.
- `pin_relationships`: emit `[]`. Cross-pin conditions stated in prose (e.g. "EN must be ≥ 1.4 V referenced to VIN") belong to the pinout task, which records them in the pin's `notes`.

## Hard rules

1. **Canonical SI units everywhere.** Voltage in `V`, current in `A`, resistance in `Ω`, capacitance in `F` (NOT µF — store 470 µF as `4.7e-4` with unit `F`), inductance in `H`, frequency in `Hz`, temperature in `°C`, time in `s`, charge in `C`, power in `W`. Thermal resistance in `°C/W`.
2. **Every numeric SpecValue requires an `evidence` block** with `page` (PDF page where the value was read), `section` (textual section name from the PDF), `confidence` (`high` for table values, `medium` for prose, `low` for ambiguous/inferred), and `method` (one of `table`, `prose`, `curve`, `calculated`, `derived`). Use `curve` for values read off a graph, `calculated` for values resolved from a symbolic expression, `derived` for values inferred from other facts.
3. **OMIT fields you cannot locate** rather than guessing. Required: `family` (string), `package` (with `code`), `absolute_max`, `recommended_operating` (objects, `{}` when the datasheet lists none) and `pinout` (`[]` here). Everything else may be omitted; `compliance` and `pin_relationships` are arrays (`[]` when empty, never null), and the other optional fields may be null. An empty value is much better than a hallucinated one.
4. **For family PDFs**, extract values applicable to `{{MPN}}`. If a value is family-wide (e.g., absolute max VIN), state it. If it is variant-specific, state the variant value. Use `notes` field to call out variant-specific spec.
5. **No pinout data here** (`"pinout": []`). The pinout subagent runs separately.

## Output format

Return only the JSON object — no surrounding prose, no Markdown code fences. Output must validate against `{{SCHEMA_PATH}}`.

Example (abbreviated; `recommended_operating` is filled the same way as `absolute_max`):

```json
{
  "family": "step-down switching regulator",
  "package": {
    "code": "TO-263-5",
    "pin_count": 5,
    "thermal_pad": true,
    "evidence": {"page": 1, "section": "Features", "confidence": "medium", "method": "prose"}
  },
  "thermal": {
    "theta_ja": [{"min": null, "typ": 50, "max": null, "unit": "°C/W",
                  "condition": "TO-263 mounted vertically, 1oz Cu, 1in² pour", "notes": null,
                  "evidence": {"page": 5, "section": "Thermal Information", "confidence": "high", "method": "table"}}]
  },
  "absolute_max": {
    "VIN_max": [{"max": 45, "unit": "V", "min": null, "typ": null, "condition": null, "notes": null,
                 "evidence": {"page": 5, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}]
  },
  "recommended_operating": {},
  "moisture_sensitivity": {"msl": 3, "peak_reflow_c": 260},
  "compliance": [{"mark": "RoHS", "rating": null}],
  "pinout": []
}
```
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