Agent skill for docs-api-openapi - invoke with $agent-docs-api-openapi
Install with Tessl CLI
npx tessl i github:ruvnet/claude-flow --skill agent-docs-api-openapi35
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Reusable components and OpenAPI structure
OpenAPI 3.0 version
100%
100%
Info section present
100%
100%
Servers section present
100%
100%
Tags used for grouping
0%
100%
Operation IDs defined
100%
100%
$ref for Product schema
100%
100%
$ref for Category schema
100%
75%
$ref for Error schema
100%
100%
Accurate Product properties
100%
100%
Error responses documented
100%
100%
Response examples included
0%
100%
application/json content type
100%
100%
Output file location
100%
100%
Without context: $0.1861 · 40s · 10 turns · 12 in / 3,014 out tokens
With context: $0.4885 · 1m 41s · 21 turns · 60 in / 7,089 out tokens
Security schemes and rate limiting documentation
OpenAPI 3.0 version
100%
100%
API key security scheme
100%
100%
Bearer token security scheme
100%
100%
Security applied to operations
100%
100%
Rate limit documentation
100%
100%
429 responses documented
100%
100%
401 responses documented
100%
100%
403 responses documented
100%
100%
Info and servers sections
100%
100%
Schemas in components
100%
100%
Response examples
100%
100%
Operation IDs defined
100%
100%
Descriptive summaries
100%
100%
Without context: $0.4707 · 1m 51s · 17 turns · 22 in / 8,316 out tokens
With context: $0.4989 · 2m 3s · 17 turns · 25 in / 9,908 out tokens
Descriptive summaries, error documentation, and examples
OpenAPI 3.0 version
40%
100%
Info and servers sections
100%
100%
Summaries on all operations
100%
100%
Descriptions on operations
100%
100%
Tags for grouping
100%
100%
Operation IDs defined
100%
100%
400 error responses
100%
100%
404 error responses
100%
100%
Non-standard error codes documented
100%
100%
Success response examples
100%
100%
Error response examples
100%
100%
$ref for schemas
100%
100%
application/json content type
100%
100%
Output file type
100%
100%
Without context: $0.4247 · 1m 56s · 11 turns · 13 in / 9,958 out tokens
With context: $0.6024 · 2m 20s · 20 turns · 442 in / 10,676 out tokens
Table of Contents
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.