openapi-spec-generator

Openapi Spec Generator - Auto-activating skill for API Development. Triggers on: openapi spec generator, openapi spec generator Part of the API Development skill category.

1.04x

Quality

Does it follow best practices?

Impact

99%

1.04x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./planned-skills/generated/15-api-development/openapi-spec-generator/SKILL.md

Evaluation results

100%

Task Management API Specification

Production-ready REST API spec

Criteria

Without context

With context

OpenAPI 3.x format

100%

Security scheme defined

100%

Security applied to endpoints

100%

Correct HTTP methods

100%

Error status codes

100%

Request/response schemas

100%

Example values

100%

Path parameters defined

100%

Info and versioning

100%

Tags used for grouping

100%

Content-type specified

100%

README produced

100%

Without context: $0.4041 · 1m 51s · 15 turns · 66 in / 9,235 out tokens

With context: $0.6215 · 2m 28s · 27 turns · 108 in / 10,800 out tokens

100%

15%

Legacy API Spec Cleanup and Validation

Spec validation with curl

Criteria

Without context

With context

OpenAPI 3.x migration

100%

curl used for validation

100%

Validation report present

100%

Security scheme added

100%

Error responses added

100%

Request body format updated

100%

Schema components defined

100%

Path parameters preserved

100%

No Swagger 2.0 artifacts

100%

Servers block present

100%

Without context: $0.2642 · 1m 10s · 16 turns · 17 in / 4,642 out tokens

With context: $0.4498 · 1m 33s · 26 turns · 192 in / 5,757 out tokens

98%

-2%

E-Commerce GraphQL API Schema

GraphQL API schema design

Criteria

Without context

With context

Valid GraphQL SDL

100%

Query type defined

100%

Mutation type defined

100%

Product variants modeled

100%

Description comments used

100%

Input types for mutations

100%

80%

Pagination pattern

100%

Non-null types used appropriately

100%

Category browsing included

100%

Schema notes document

100%

Realistic field names

100%

Without context: $0.2719 · 1m 39s · 12 turns · 13 in / 5,854 out tokens

With context: $0.4812 · 2m 30s · 23 turns · 55 in / 8,213 out tokens

Repository: jeremylongshore/claude-code-plugins-plus-skills
Commit: 0c08951

Evaluated: 18 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Task Management API Specification Legacy API Spec Cleanup and Validation E-Commerce GraphQL API Schema

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.