Author and validate an OpenAPI document that generators accept: schema reuse, discriminated payloads, and examples that stay in step with the schema.
SkillScore100Maintained
Automatic
◆Coding pack
Last verified 8/3/2026
What it changes
Passed 22 of 22 test cases with the skill, and 21 of 22 without it.
Without skill95%
With skill100%
Checks it passed that the model alone missed
The UserEvent schema includes a discriminator object.
The discriminator object specifies a propertyName field.
1 fixed21 passed either way0 still failing0 broke
Pass-rate lift
+5 pp
Tokens
-2%
Agent turns
0%
Response time
-3%
Model gemini-3.6-flashMeasured 8/3/2026v122 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
A test case the skill fixed. Same model, same prompt, with and without the skill.
Prompt
Here is a draft OpenAPI JSON file for my user management service. Please review and fix it so that client SDK generators won't choke on it. Specifically, refactor the inline definitions into reusable references, set up proper type discrimination for the 'UserEvent' webhook payload, and ensure all the mock payloads provided in the spec actually validate against their respective definitions. Return the corrected JSON.
What was checked, without and with the skill
Checked
Without skill
With skill
The output uses the $ref keyword for schema reuse.
Passed
Passed
The UserEvent schema includes a discriminator object.
Missed
Passed
The discriminator object specifies a propertyName field.
Missed
Passed
case-01 · gemini-3.6-flash · 8/3/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md4 linessingle file
openapi-specs
Author and validate an OpenAPI document that generators accept: schema reuse,
discriminated payloads, and examples that stay in step with the schema.