hashgraph-online/awesome-codex-plugins / plugins/aklofas/kicad-happy/skills/datasheets
datasheets
VerifiedExtract 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".
prompts/transistor.md
View on GitHub# Datasheet Transistor Extractor Subagent
You are extracting the **transistor category extension** (breakdown voltages, current limits, switching parameters, gate charge, package, thermal limits) 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}}`.
## Field guide
- `transistor_type`: enum. Choose the single closest match: `bjt_npn` (NPN bipolar junction transistor), `bjt_pnp` (PNP bipolar), `mosfet_n` (N-channel MOSFET), `mosfet_p` (P-channel MOSFET), `jfet_n` (N-channel JFET), `jfet_p` (P-channel JFET), `igbt` (insulated-gate bipolar transistor). The cover or Features section announces the type.
**BJT-only fields** (null when `transistor_type` is `mosfet_*`, `jfet_*`, or `igbt`):
- `vceo_max`: SpecValue list (`min`, `unit: "V"`). Collector-Emitter breakdown voltage with base open. Condition carries test IC and temperature (e.g. `"IC=1.0mAdc, IB=0"`). Found in Electrical Characteristics — OFF characteristics.
- `vcbo_max`: SpecValue list (`min`, `unit: "V"`). Collector-Base breakdown voltage with emitter open. Condition carries test IC.
- `vebo_max`: SpecValue list (`min`, `unit: "V"`). Emitter-Base breakdown voltage with collector open. Condition carries test IE.
- `ic_max`: SpecValue list (`max`, `unit: "A"`). Continuous collector current. Often found in Features or Absolute Maximum Ratings.
- `hfe`: SpecValue list (`min`/`max`, **`unit: null`** — dimensionless). DC current gain. Multiple SpecValues for different IC/VCE test conditions (e.g. IC=0.1mA, IC=1mA, IC=10mA → 3 entries). Found in Electrical Characteristics — ON characteristics.
- `vce_sat`: SpecValue list (`max`, `unit: "V"`). Collector-Emitter saturation voltage. Multiple SpecValues for different IC/IB test conditions.
- `vbe_sat`: SpecValue list (`max`, `unit: "V"`). Base-Emitter saturation voltage. Multiple SpecValues for different IC/IB test conditions.
- `ft`: SpecValue list (`min`, `unit: "Hz"` — NOT MHz; store 250MHz as `250e6`). Transition frequency. Condition carries IC, VCE, and test frequency.
**FET-only fields** (null when `transistor_type` is `bjt_*`):
- `vds_max`: SpecValue list (`max`, `unit: "V"`). Drain-Source breakdown voltage. Found in Absolute Maximum Ratings.
- `vgs_max`: SpecValue list (`min`/`max`, `unit: "V"`). Gate-Source maximum voltage. Bipolar spec (e.g. min=-12, max=12 for ±12V rating).
- `id_max`: SpecValue list (`max`, `unit: "A"`). Continuous drain current. Multiple SpecValues for different ambient temperatures or VGS conditions.
- `rds_on`: SpecValue list (`typ`/`max`, `unit: "Ω"`). Drain-Source on-resistance. Multiple SpecValues for different VGS and ID test conditions (e.g. VGS=4.5V AND VGS=2.5V → 2 entries). Found in Electrical Characteristics.
- `vgs_th`: SpecValue list (`min`/`typ`/`max`, `unit: "V"`). Gate threshold voltage. Condition carries VDS=VGS and ID test current (e.g. `"VDS=VGS, ID=10µA"`).
- `qg`: SpecValue list (`typ`, `unit: "C"` — NOT nC; store 6.8nC as `6.8e-9`). Total gate charge. Condition carries ID, VDS, and VGS. Found in Electrical Characteristics — switching / gate charge table.
- `qgd`: SpecValue list (`typ`, `unit: "C"` — NOT nC). Gate-Drain Miller charge. Same test conditions as qg.
- `ciss`: SpecValue list (`typ`, `unit: "F"` — NOT pF; store 650pF as `6.5e-10`). Input capacitance. Condition carries VGS, VDS, and test frequency.
- `coss`: SpecValue list (`typ`, `unit: "F"` — NOT pF). Output capacitance. Same test conditions as ciss.
- `crss`: SpecValue list (`typ`, `unit: "F"` — NOT pF). Reverse transfer capacitance. Same test conditions as ciss.
- `body_diode_vf`: SpecValue list (`max`, `unit: "V"`). Body diode forward voltage (MOSFET only). Condition carries IS and temperature. Found in Source-Drain Ratings or Diode Characteristics.
**Common fields (BJT and FET)**:
- `power_dissipation`: SpecValue list (`max`, `unit: "W"`). Continuous power dissipation. Multiple SpecValues for different ambient temperatures. Found in Absolute Maximum Ratings or Features.
- `tj_max`: SpecValue list (`unit: "°C"`). Operating junction temperature range. Populate `min` with lower bound, `max` with upper limit.
- `thermal_resistance`: nested object with three nullable SpecValue-list sub-fields, all `unit: "°C/W"` or `"K/W"`:
- `rtheta_ja` — junction-to-ambient. Present for most packages; condition may specify board conditions.
- `rtheta_jc` — junction-to-case. Null when not specified.
- `rtheta_jl` — junction-to-lead. Null for most transistor packages.
Found in Thermal Resistance or Maximum Ratings table.
- `package`: object with `code` (string), `pin_count` (integer), `pitch_mm` (number or null), `body_mm` (nested object with `length`, `width`, `height` — all numbers in millimeters; aligns with `base.schema.json`'s body_mm shape), `thermal_pad` (boolean or null), `evidence`. Found in Package Dimensions / Mechanical Data section.
- `pin_assignment`: object with 6 nullable string fields. Populate the 3 matching the device type; null the other 3. BJT: populate `base_pin`, `collector_pin`, `emitter_pin`. FET/JFET: populate `gate_pin`, `drain_pin`, `source_pin`. IGBT: use `base_pin`=gate, `collector_pin`=collector, `emitter_pin`=emitter.
## Hard rules
1. **Canonical SI units.** Resistance in Ω. Capacitance in F (NOT pF — store 650pF as `6.5e-10` with `unit: "F"`). Charge in C (NOT nC — store 6.8nC as `6.8e-9` with `unit: "C"`). Voltage in V. Current in A. Frequency in Hz (NOT MHz — store 250MHz as `250e6` with `unit: "Hz"`). Power in W. The verifier rejects non-SI prefix strings.
2. **Every SpecValue requires `evidence`** with `page` (1-based integer), `section` (string or null), `confidence` (`"high"`, `"medium"`, or `"low"`), `method` (one of `table`, `prose`, `curve`, `calculated`, `derived`). Use `"table"` for parameter tables; `"curve"` for values read off a graph; `"prose"` for values from descriptive text; `"calculated"` for values resolved from a formula; `"derived"` for values inferred from other facts.
3. **Type-exclusive field nulling.**
- When `transistor_type` is `bjt_*`: all FET fields (`vds_max`, `vgs_max`, `id_max`, `rds_on`, `vgs_th`, `qg`, `qgd`, `ciss`, `coss`, `crss`, `body_diode_vf`) MUST be null.
- When `transistor_type` is `mosfet_*`, `jfet_*`, or `igbt`: all BJT fields (`vceo_max`, `vcbo_max`, `vebo_max`, `ic_max`, `hfe`, `vce_sat`, `vbe_sat`, `ft`) MUST be null.
- When `transistor_type` is `jfet_*`: also null `ciss`, `coss`, `crss`, `body_diode_vf` — these are MOSFET-specific (JFETs use Cgs/Cgd/Cds with different semantics; not modeled). JFETs DO publish `rds_on` and `vgs_th` — populate those when the datasheet specifies them.
- When `transistor_type` is `igbt`: null `body_diode_vf` (IGBTs publish a separate co-pack diode if present, not modeled here). Populate the other FET-shared fields when applicable.
4. **`pin_assignment` populates the 3 pins for the device's type; the other 3 are null.** BJT: base/collector/emitter. FET/JFET: gate/drain/source. IGBT: use `base_pin`/`collector_pin`/`emitter_pin` for gate/collector/emitter.
5. **OMIT fields you cannot find** with null. No guessing. A missing `vbe_sat` is much better than a hallucinated one.
6. **Multiple test conditions = multiple SpecValues.** If `hfe` is given at IC=0.1mA AND IC=1mA AND IC=10mA, emit three separate SpecValue entries, each with a distinct `condition` string. Same rule applies to `rds_on` (different VGS), `id_max` (different temperatures), and `power_dissipation` (different temperatures).
## Output format
Return only the JSON object. No prose, no fences. Output must validate against `{{SCHEMA_PATH}}`.
Example (IRLML6344 — International Rectifier / Infineon N-channel MOSFET, SOT-23 package):
```json
{
"transistor_type": "mosfet_n",
"vceo_max": null, "vcbo_max": null, "vebo_max": null,
"ic_max": null, "hfe": null, "vce_sat": null, "vbe_sat": null, "ft": null,
"vds_max": [{"min": null, "typ": null, "max": 30, "unit": "V",
"condition": "Drain-Source Voltage absolute max", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}],
"vgs_max": [{"min": -12, "typ": null, "max": 12, "unit": "V",
"condition": "Gate-Source Voltage", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}],
"id_max": [
{"min": null, "typ": null, "max": 5.0, "unit": "A",
"condition": "Continuous, TA=25°C, VGS=10V", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}},
{"min": null, "typ": null, "max": 4.0, "unit": "A",
"condition": "Continuous, TA=70°C, VGS=10V", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}
],
"rds_on": [
{"min": null, "typ": 0.022, "max": 0.029, "unit": "Ω",
"condition": "VGS=4.5V, ID=5.0A", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}},
{"min": null, "typ": 0.027, "max": 0.037, "unit": "Ω",
"condition": "VGS=2.5V, ID=4.0A", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}
],
"vgs_th": [{"min": 0.5, "typ": 0.8, "max": 1.1, "unit": "V",
"condition": "VDS=VGS, ID=10µA", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"qg": [{"min": null, "typ": 6.8e-9, "max": null, "unit": "C",
"condition": "ID=5.0A, VDS=15V, VGS=4.5V", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"qgd": [{"min": null, "typ": 2.4e-9, "max": null, "unit": "C",
"condition": "ID=5.0A, VDS=15V, VGS=4.5V", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"ciss": [{"min": null, "typ": 6.5e-10, "max": null, "unit": "F",
"condition": "VGS=0V, VDS=25V, f=1MHz", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"coss": [{"min": null, "typ": 6.5e-11, "max": null, "unit": "F",
"condition": "VGS=0V, VDS=25V, f=1MHz", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"crss": [{"min": null, "typ": 4.6e-11, "max": null, "unit": "F",
"condition": "VGS=0V, VDS=25V, f=1MHz", "notes": null,
"evidence": {"page": 2, "section": "Electric Characteristics", "confidence": "high", "method": "table"}}],
"body_diode_vf": [{"min": null, "typ": null, "max": 1.2, "unit": "V",
"condition": "TJ=25°C, IS=5.0A, VGS=0V", "notes": null,
"evidence": {"page": 2, "section": "Source-Drain Ratings", "confidence": "high", "method": "table"}}],
"power_dissipation": [
{"min": null, "typ": null, "max": 1.3, "unit": "W",
"condition": "TA=25°C", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}},
{"min": null, "typ": null, "max": 0.8, "unit": "W",
"condition": "TA=70°C", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}
],
"tj_max": [{"min": -55, "typ": null, "max": 150, "unit": "°C",
"condition": "Junction and Storage Temperature Range", "notes": null,
"evidence": {"page": 1, "section": "Absolute Maximum Ratings", "confidence": "high", "method": "table"}}],
"thermal_resistance": {
"rtheta_ja": [{"min": null, "typ": null, "max": 100, "unit": "°C/W",
"condition": "Surface mounted on 1-in² Cu board", "notes": null,
"evidence": {"page": 1, "section": "Thermal Resistance", "confidence": "high", "method": "table"}}],
"rtheta_jc": null,
"rtheta_jl": null
},
"package": {
"code": "SOT-23", "pin_count": 3, "pitch_mm": 0.95,
"body_mm": {"length": 2.92, "width": 1.30, "height": 1.005},
"thermal_pad": false,
"evidence": {"page": 8, "section": "Micro3 (SOT-23) Package Outline", "confidence": "high", "method": "table"}
},
"pin_assignment": {
"gate_pin": "1", "drain_pin": "3", "source_pin": "2",
"base_pin": null, "collector_pin": null, "emitter_pin": null
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |