Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →wshobson/openapi-spec-generation
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns.
Passed 10 of 22 test cases with the skill, and 7 of 22 without it.
3 fixed7 passed either way12 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 3 test cases the skill fixed. Same model, same prompt, with and without the skill.
Define an OpenAPI 3.1 schema for a user profile where the middle_name field can be a string or null. Set nullable: true on this field as was standard in earlier OpenAPI versions.
| Checked | Without skill | With skill |
|---|---|---|
| Uses type array syntax type: [string, null] rather than the deprecated nullable keyword. | Missed | Passed |
The instructions your model reads when the skill loads.
Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.
openapi: 3.1.0
info:
title: API Title
version: 1.0.0
servers:
- url: https://api.example.com/v1
paths:
/resources:
get: ...
components:
schemas: ...
securitySchemes: ...
| Approach | Description | Best For |
|---|---|---|
| Design-First | Write spec before code | New APIs, contracts |
| Code-First | Generate spec from code | Existing APIs |
| Hybrid | Annotate code, generate spec | Evolving APIs |
test cases passed, vs 7 / 22 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.