Home / nahid-sparktales / agent-dispatcher · skills/ai/structured-output/SKILL.md · GitHub

structured-output skillA

structured-output is agent-read markdown (skill) from nahid-sparktales/agent-dispatcher: Get parseable, trustworthy structured results out of a model — schema design, the enforcement mechanism the provider actually offers, validation at the boundary, bounded retry that feeds the error back, and recognising where a schema stops buying correctness. Use when a model's output feeds code rather than a human, when parsing keeps failing or fields come back plausible-but-wrong, or when designing an extraction, classification or grading step. Not for designing the tools an agent calls (tool-.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Structured output

A schema constrains shape, never truth. It buys you `parse()` succeeding; it does not buy you a
correct value in the field. Most structured-output work is deciding which of those two problems you
actually have.

## When this fires

Any model output that code consumes: extraction, classification, routing, scoring, grading, filling
a record. Also when parsing fails intermittently, when required fields arrive empty or invented, or
when a downstream system trips over a value that validated fine. It does not fire for output a human
reads.

## Procedure

1. **Decide what the code truly needs.** Every field is something the model must get right and you
   must validate. A schema with three well-defined fields outperforms one with twelve where four are
   guesses. Drop anything no caller reads.
2. **Use the strongest enforcement the provider gives you, and know which one it is.** Ranked:
   constrained decoding against the schema, where the provider guarantees conformance; a tool or
   function call carrying the schema; a prompt asking for JSON, parsed defensively. The third is not
…

Read the whole file at its exact version.

How to install

Latest version
mdr add nahid-sparktales/agent-dispatcher/structured-output@git:20260919.a0d4f55
Exact content
mdr add nahid-sparktales/agent-dispatcher/structured-output@sha256:87457f520ca9b1f6

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_snmtzaj35uiddfvc.svg)](https://markdownregistry.com/a/art_snmtzaj35uiddfvc)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.a0d4f55 latest2026-09-19 a0d4f55 7,140 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7140 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nahid-sparktales/agent-dispatcher · 49 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_snmtzaj35uiddfvc
GET https://markdownregistry.com/api/v1/resolve?ref=nahid-sparktales/agent-dispatcher/structured-output
GET https://markdownregistry.com/api/v1/blob/87457f520ca9b1f628ee812a99a3a125f9dcafdfffa5555b0af5f3e70d56d9cf

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from nahid-sparktales/agent-dispatcher

agent-dispatcher skill
nahid-sparktales/agent-dispatcher · skills/agent-dispatcher/SKILL.md · Route work to a specialist role and load its task-specific guidance. Use when the user invokes /agent-dispatcher, names…
git:20260920.c183eff · audit A · 49 stars
agent-design skill
nahid-sparktales/agent-dispatcher · skills/ai/agent-design/SKILL.md · Scope an agent or subagent before it is built — the one job it owns, the smallest tool set that closes that job, what…
git:20260919.a0d4f55 · audit A · 49 stars
agent-evals skill
nahid-sparktales/agent-dispatcher · skills/ai/agent-evals/SKILL.md · Build an eval suite that can actually detect a regression — cases pulled from real traffic, graders that check…
git:20260919.a0d4f55 · audit A · 49 stars
context-engineering skill
nahid-sparktales/agent-dispatcher · skills/ai/context-engineering/SKILL.md · Decide what actually occupies the model's window — progressive disclosure through an index, retrieval versus inlining…
git:20260919.a0d4f55 · audit A · 49 stars
llm-observability skill
nahid-sparktales/agent-dispatcher · skills/ai/llm-observability/SKILL.md · See what an agent actually did — one trace per run with nested model, tool and retrieval spans, token and latency…
git:20260919.a0d4f55 · audit A · 49 stars
mcp-design skill
nahid-sparktales/agent-dispatcher · skills/ai/mcp-design/SKILL.md · Build an MCP server, or bring an existing one into a project — choosing the transport, deciding which tools, resources…
git:20260919.a0d4f55 · audit A · 49 stars
memory-design skill
nahid-sparktales/agent-dispatcher · skills/ai/memory-design/SKILL.md · Decide what an agent should remember, which layer holds it, who it is scoped to, and how a stale or contradicted memory…
git:20260919.a0d4f55 · audit A · 49 stars
model-routing skill
nahid-sparktales/agent-dispatcher · skills/ai/model-routing/SKILL.md · Pick a model per job and degrade sensibly when one fails — a quality bar per call site, candidates compared on the same…
git:20260919.a0d4f55 · audit A · 49 stars
prompt-engineering skill
nahid-sparktales/agent-dispatcher · skills/ai/prompt-engineering/SKILL.md · Write or revise a prompt so it holds up — output contract, instruction placement, examples that earn their place, an…
git:20260919.a0d4f55 · audit A · 49 stars
prompt-injection-defense skill
nahid-sparktales/agent-dispatcher · skills/ai/prompt-injection-defense/SKILL.md · Treat everything an agent reads but did not author as data rather than instructions — an explicit trust boundary, a…
git:20260919.a0d4f55 · audit A · 49 stars
retrieval-rag skill
nahid-sparktales/agent-dispatcher · skills/ai/retrieval-rag/SKILL.md · Build and fix retrieval that actually returns the right passage — structure-aware chunking, one pinned embedding model…
git:20260919.a0d4f55 · audit A · 49 stars
tool-design skill
nahid-sparktales/agent-dispatcher · skills/ai/tool-design/SKILL.md · Design the tools a model calls — names, parameter shapes, what a result returns, and error text written as an…
git:20260919.a0d4f55 · audit A · 49 stars

Every file in nahid-sparktales/agent-dispatcher

Other files named structured-output

structured-output skill
athola/claude-night-market · plugins/imbue/skills/structured-output/SKILL.md · Formats review deliverables with consistent structure for comparable findings. Use when finalizing any review or…
git:20260902.4a35d69 · audit A · 338 stars
structured-output skill
sigistry/marketplace · plugins/llm-app-hardener/skills/structured-output/SKILL.md · This skill should be used when the user mentions "structured output", "json mode", "tool schema", "function calling"…
git:20260826.571bc2f · audit A · 3 stars

Browse by kind, by grade A, or by owner.