validate-structured-model-output

v2026.09.24

Validates JSON or tool-call model outputs without repair, separating parse, schema, supplied-identifier, semantic, replay, and safety failures. Use for first-attempt benchmarks, teacher-label pipelines, and bounded model tool selection.

GitHub
Install command
npx skhub add bastos/validate-structured-model-output
Markdown
SKILL.md

Validate Structured Model Output

Treat model output as untrusted input. Preserve raw bytes and validate a normalized copy through ordered gates.

Validation order

  1. Transport: A native structured response or the required JSON payload exists.
  2. Parse: Decode exactly once. In acceptance benchmarks, do not extract JSON from prose or retry malformed output.
  3. Schema: Enforce required fields, types, controlled values, and cardinality.
  4. Identifiers: Reject unknown, duplicate, overlapping, invented, or off-request IDs.
  5. Semantics: Reject equivalent choices where distinctness is required and verify classifications against supplied facts.
  6. Execution: Replay or otherwise validate the selected operation with the deterministic kernel.
  7. Safety: Reject continuation through terminal, unresolved, random, hidden, or otherwise unsupported effects.

Keep failure categories separate. A parse failure is not an abstention, and a legal identifier is not proof of a safe or useful result.

Validate JSONL ID contracts

Use the bundled validator when each row contains supplied, ranked, and optional alternative IDs:

python scripts/validate_jsonl_outputs.py results.jsonl \
  --supplied-field request.planIDs \
  --ranked-field response.rankedPlanIDs \
  --alternative-field response.alternativePlanIDs \
  --max-ranked 3 --output validation-report.json

It checks duplicate IDs within arrays, overlap between ranked and alternatives, unknown IDs, rank length, and alternatives without a ranked selection. Add project validators after this generic layer.

Benchmark discipline

For first-attempt acceptance, generate once and validate without repair, remediation, or deterministic fallback. Test production remediation separately. Persist raw output, normalized output, every gate result, timing, prompt/config revision, and validator revision so failures remain auditable.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

validate-structured-model-output

Default branch

main

Latest commit

93f7d2c

Tree SHA

1944e37