CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

llm-structured-output

Get reliable JSON, enums, and typed objects from LLMs using response_format, tool_use, and schema-constrained decoding across OpenAI, Anthropic, and Google APIs.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is llm-structured-output in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, production-oriented body: fully executable multi-provider code, a numbered workflow with explicit validation and retry feedback loops, and a high density of non-obvious pitfalls. The only weaknesses are minor rhetorical padding in the prose and a single-file layout that could offload examples to a reference file.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational knowledge Claude does not already know (strict mode rejecting additionalProperties with a 400, the refusal field, partial-JSON streaming pitfalls, enum casing differences). It is not a 5 because several passages carry trimmable rationale ('This is the structured output equivalent of unit testing', 'Omitting them is equivalent to omitting half your prompt') that could be tightened; it is above 3 because padding is minor and nearly every line carries skill-specific insight.

4 / 5

Actionability

Three complete, executable examples (Pydantic with client.beta.chat.completions.parse, Anthropic tool_use with full input_schema and tool_choice, TypeScript zodResponseFormat) plus a concrete one-liner for extracting the tool_use block and a specific retry instruction string with a 3-attempt cap. Code is copy-paste ready and covers the common provider cases, matching the anchor for fully executable coverage.

5 / 5

Workflow Clarity

The 10-step core workflow has an explicit validation checkpoint ('Validate the response against the schema in your application code'), an explicit retry feedback loop with the exact instruction to send back ('Your previous output failed validation: {error}. Fix the output.') capped at 3 attempts, and a logging step for diagnosing production failures. This matches the anchor for a clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist; the single-file body (~200 lines) is well-organized into clearly labeled sections (workflow, examples, pitfalls, edge cases, best practices) that are easy to navigate. It is not a 5 because at ~200 lines some content (e.g. the three full code examples) could plausibly be split into a separate examples file to keep the overview leaner; it is not a 3 because structure is good and nothing that clearly belongs elsewhere is inlined.

4 / 5

Total

18

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, technically credible description that names the three provider mechanisms and concrete output types, but it omits any 'when to use' trigger guidance and misses the most natural user phrase 'structured output'. Adding a Use-when clause with common synonyms would lift the two weakest dimensions.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when extracting structured data from LLM responses, the user mentions structured output, JSON mode, response_format, or malformed JSON from model output.'

Include the natural phrase 'structured output' and common ecosystem terms (Pydantic, Zod, JSON mode, instructor) that users actually say when they need this skill.

Mention the validation/retry capability (e.g. 'validate and retry on schema failures') to round out coverage of what the skill does.

DimensionReasoningScore

Specificity

Names concrete mechanisms ('response_format', 'tool_use', 'schema-constrained decoding') and concrete outputs ('JSON, enums, and typed objects') across three named providers, which is several specific actions with only minor gaps (validation/retry workflow not mentioned). It is not a 5 because coverage is not comprehensive — supporting libraries like Pydantic, Zod, or instructor are absent — and not a 3 because it goes well beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear — get reliable JSON, enums, and typed objects from LLMs using named mechanisms — but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per judging guidelines caps completeness at 3. It is not a 2 because the 'what' is specific and concrete, not vague.

3 / 5

Trigger Term Quality

Includes natural technical keywords users actually say: 'JSON', 'enums', 'response_format', 'tool_use', plus provider names (OpenAI, Anthropic, Google). It is not a 5 because the most natural user phrase 'structured output' is missing, along with common variations like 'JSON mode', 'Pydantic', 'Zod', or 'instructor'; it is above 3 because coverage of API-level terms is solid.

4 / 5

Distinctiveness Conflict Risk

A clear niche (structured extraction from LLM APIs) with distinct triggers like 'response_format' and 'schema-constrained decoding'. Not a 5 because the mention of 'tool_use' could overlap with genuine tool-orchestration queries and general LLM-API-calling skills; not a 3 because the specificity of the API mechanisms makes wrong-skill triggering unlikely.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/llm-structured-output/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.