swagger-doc-creator

Swagger Doc Creator - Auto-activating skill for API Development. Triggers on: swagger doc creator, swagger doc creator Part of the API Development skill category.

0.97x

Quality

Does it follow best practices?

Impact

97%

0.97x

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/swagger-doc-creator/SKILL.md

Evaluation results

92%

-6%

Product Catalog API Documentation

OpenAPI spec quality and best practices

Criteria

Without context

With context

OpenAPI version declared

75%

Info object complete

100%

Minimum endpoint coverage

100%

Correct HTTP methods

100%

HTTP status codes

100%

Reusable components

100%

Security scheme defined

100%

Security applied to endpoints

100%

Request/response schemas

100%

Content-type declared

100%

Endpoint grouping with tags

100%

Parameter documentation

100%

Without context: $0.4954 · 2m 4s · 19 turns · 20 in / 9,203 out tokens

With context: $0.4984 · 1m 51s · 20 turns · 100 in / 9,017 out tokens

100%

User Management API Documentation and Validation

curl-based API validation workflow

Criteria

Without context

With context

curl script created

100%

HTTP method flags in curl

100%

Headers in curl calls

100%

OpenAPI spec produced

100%

Spec matches script endpoints

100%

Minimum three endpoints tested

100%

Error response testing

100%

Response documentation in spec

100%

Validation output captured

100%

Script documentation

100%

Without context: $0.4678 · 1m 48s · 21 turns · 21 in / 8,681 out tokens

With context: $0.4820 · 1m 48s · 24 turns · 98 in / 7,305 out tokens

100%

Multi-Tenant Analytics Platform API Documentation

Authentication scheme documentation

Criteria

Without context

With context

Multiple security schemes

100%

securitySchemes location

100%

Differentiated endpoint security

100%

Bearer/JWT scheme type

100%

API key scheme type

100%

Public endpoints identified

100%

Auth error responses

100%

Security scheme description

100%

Security applied via reference

100%

Auth header naming convention

100%

Without context: $0.3218 · 1m 27s · 12 turns · 13 in / 6,623 out tokens

With context: $0.4822 · 1m 56s · 28 turns · 285 in / 7,605 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

Product Catalog API Documentation User Management API Documentation and Validation Multi-Tenant Analytics Platform API Documentation

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.