api-documentation

API documentation workflow for generating OpenAPI specs, creating developer guides, and maintaining comprehensive API documentation.

1.11x

Quality

38%

Does it follow best practices?

Impact

95%

1.11x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/antigravity-api-documentation/SKILL.md

Evaluation results

100%

10%

Document the TaskFlow User Management API

Complete API documentation workflow

Criteria

Without context

With context

Auth scheme in OpenAPI

100%

Paths with schemas

100%

Error responses in OpenAPI

100%

Examples in OpenAPI

100%

Rate limits noted

100%

Getting started section

100%

Authentication guide

100%

Troubleshooting section

100%

FAQ section

100%

curl examples

100%

Without context: $0.5891 · 2m 19s · 20 turns · 27 in / 11,007 out tokens

With context: $0.8603 · 3m 34s · 28 turns · 36 in / 15,397 out tokens

100%

10%

Create a Formal API Specification for PayStream

OpenAPI specification generation

Criteria

Without context

With context

All endpoints as paths

100%

Request body schemas

100%

Response schemas

100%

Security scheme defined

100%

Security applied to paths

100%

Error responses documented

100%

Rate limit information

100%

Examples included

100%

Parameters documented

100%

API info section

100%

Without context: $0.2896 · 1m 13s · 13 turns · 19 in / 5,249 out tokens

With context: $0.5938 · 2m 4s · 24 turns · 436 in / 9,082 out tokens

85%

10%

Create Developer Onboarding Documentation for the WeatherNow API

Developer guide and code examples

Criteria

Without context

With context

Getting started section

100%

Authentication guide

100%

Common patterns section

30%

40%

Troubleshooting section

60%

100%

FAQ section

50%

curl examples

100%

Programmatic code examples

100%

Tutorial or step-by-step guide

60%

Error handling guidance

100%

Rate limit guidance

100%

Without context: $0.4605 · 1m 52s · 14 turns · 21 in / 8,707 out tokens

With context: $0.6284 · 2m 31s · 24 turns · 28 in / 9,563 out tokens

Repository: boisenoise/skills-collections
Commit: 5c5ae21

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

Table of Contents

Document the TaskFlow User Management API Create a Formal API Specification for PayStream Create Developer Onboarding Documentation for the WeatherNow API

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.