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".
scripts/validate_extraction_result.py
View on GitHub#!/usr/bin/env python3
"""Validate a single per-task extraction result against its schema.
Wraps the inline per-task validator that `merge_results.py` runs at extract
time, exposed as a standalone CLI for the harness 4-check acceptance gate
(Check 1).
Input: a wrapped result file
{task_id, schema_version, status, extracted_at, model_tier, model_id, data}
The `data` field is validated against `skills/datasheets/schemas/<task-type>.schema.json`.
Exit codes:
0 data validates and status == "complete"
1 schema validation failed, status != "complete", or unreadable result
2 CLI / I/O error (missing schema, missing file, bad JSON in result wrapper)
Designed for `--task-type` to be any task name backed by a sibling
`<name>.schema.json` — the mcu/opamp/transistor/diode/crystal tasks work
without code changes.
"""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
from extraction_schema import validate_against_schema
SCHEMA_DIR = Path(__file__).resolve().parents[1] / "schemas"
def _resolve_schema(task_type: str) -> Path:
return SCHEMA_DIR / f"{task_type}.schema.json"
def validate_result(result_file: Path, task_type: str) -> "tuple[int, str]":
"""Return (exit_code, message). exit_code semantics match module docstring."""
schema_path = _resolve_schema(task_type)
if not schema_path.exists():
return 2, f"schema not found for task-type {task_type!r}: {schema_path}"
if not result_file.exists():
return 2, f"result file not found: {result_file}"
try:
wrapper = json.loads(result_file.read_text(encoding="utf-8"))
except (json.JSONDecodeError, RecursionError) as exc:
return 2, f"result file is not valid JSON: {exc}"
status = wrapper.get("status")
if status != "complete":
err = wrapper.get("error") or "no error message provided"
return 1, f"result status is {status!r} (expected 'complete'): {err}"
if "data" not in wrapper:
return 1, "result wrapper has no 'data' field"
schema = json.loads(schema_path.read_text(encoding="utf-8"))
err = validate_against_schema(wrapper["data"], schema)
if err:
return 1, f"schema validation: {err}"
return 0, f"valid: {result_file.name} matches {schema_path.name}"
def main(argv: "list[str] | None" = None) -> int:
ap = argparse.ArgumentParser(
description=(
"Validate a single per-task extraction result against its declared schema. "
"Used by the harness 4-check gate (Check 1)."
),
)
ap.add_argument(
"--result-file",
type=Path,
required=True,
help="path to <mpn>.<task_id>.result.json",
)
ap.add_argument(
"--task-type",
required=True,
help="task name; resolves to skills/datasheets/schemas/<task-type>.schema.json",
)
ap.add_argument(
"--json",
dest="emit_json",
action="store_true",
help="emit a JSON summary to stdout instead of human text",
)
args = ap.parse_args(argv)
code, message = validate_result(args.result_file, args.task_type)
if args.emit_json:
json.dump(
{
"valid": code == 0,
"exit_code": code,
"message": message,
"result_file": str(args.result_file),
"task_type": args.task_type,
},
sys.stdout,
indent=2,
)
sys.stdout.write("\n")
else:
stream = sys.stdout if code == 0 else sys.stderr
print(message, file=stream)
return code
if __name__ == "__main__":
for _stream in (sys.stdout, sys.stderr): # UTF-8 on a cp1252 pipe (Windows)
if hasattr(_stream, "reconfigure"):
_kw = {"newline": "\n"}
if (getattr(_stream, "encoding", "") or "").lower().replace("-", "") != "utf8":
_kw.update(encoding="utf-8", errors="backslashreplace")
_stream.reconfigure(**_kw)
sys.exit(main())
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: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |