agent-docs-api-openapi

Agent skill for docs-api-openapi - invoke with $agent-docs-api-openapi

1.06x

Quality

Does it follow best practices?

Impact

99%

1.06x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/agent-docs-api-openapi/SKILL.md

Evaluation results

98%

14%

Product Catalog API Documentation

Reusable components and OpenAPI structure

Criteria

Without context

With context

OpenAPI 3.0 version

100%

Info section present

100%

Servers section present

100%

Tags used for grouping

100%

Operation IDs defined

100%

$ref for Product schema

100%

$ref for Category schema

100%

75%

$ref for Error schema

100%

Accurate Product properties

100%

Error responses documented

100%

Response examples included

100%

application/json content type

100%

Output file location

100%

Financial Data API Documentation

Security schemes and rate limiting documentation

Criteria

Without context

With context

OpenAPI 3.0 version

100%

API key security scheme

100%

Bearer token security scheme

100%

Security applied to operations

100%

Rate limit documentation

100%

429 responses documented

100%

401 responses documented

100%

403 responses documented

100%

Info and servers sections

100%

Schemas in components

100%

Response examples

100%

Operation IDs defined

100%

Descriptive summaries

100%

Customer Support Ticketing API Documentation

Descriptive summaries, error documentation, and examples

Criteria

Without context

With context

OpenAPI 3.0 version

40%

100%

Info and servers sections

100%

Summaries on all operations

100%

Descriptions on operations

100%

Tags for grouping

100%

Operation IDs defined

100%

400 error responses

100%

404 error responses

100%

Non-standard error codes documented

100%

Success response examples

100%

Error response examples

100%

$ref for schemas

100%

application/json content type

100%

Output file type

100%

Repository: ruvnet/claude-flow
Commit: f547cec

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

Table of Contents

Product Catalog API Documentation Financial Data API Documentation Customer Support Ticketing 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.