api-patterns

API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.

1.03x

Quality

60%

Does it follow best practices?

Impact

100%

1.03x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

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

Evaluation results

100%

E-Commerce Order Management API

REST resource naming and response format

Criteria

Without context

With context

Plural resource names

100%

Nouns not verbs

100%

Lowercase with hyphens

100%

Nested relationship path

100%

Correct HTTP methods

100%

201 on creation

100%

422 for validation failure

100%

404 for not found

100%

Consistent response format

87%

100%

Error includes error code

100%

Error includes user message

100%

Error includes request ID

100%

No internal details in errors

100%

Without context: $0.3630 · 4m 38s · 22 turns · 28 in / 5,357 out tokens

With context: $0.6243 · 5m 13s · 31 turns · 1,802 in / 7,188 out tokens

100%

Platform Architecture API Consultation

API style selection and versioning strategy

Criteria

Without context

With context

REST for public API

100%

tRPC for TS monorepo

100%

GraphQL for social graph

100%

URI versioning for public API

100%

No versioning for GraphQL

100%

No versioning for tRPC

100%

Consumer question addressed

100%

TypeScript constraint addressed

100%

tRPC not for public API

100%

Data complexity factor

100%

Caching or HTTP factor

100%

Without context: $0.2351 · 2m 34s · 12 turns · 19 in / 4,068 out tokens

With context: $0.3419 · 3m 13s · 19 turns · 445 in / 4,512 out tokens

100%

Securing a Public Weather Data API

Rate limiting headers and JWT authentication principles

Criteria

Without context

With context

X-RateLimit-Limit header

100%

X-RateLimit-Remaining header

100%

X-RateLimit-Reset header

100%

429 status on exceeded

100%

Token bucket strategy

100%

JWT signature verification

100%

JWT expiration check

100%

Short JWT expiry

100%

Refresh token support

100%

Minimal JWT claims

100%

No sensitive data in JWT

100%

Token bucket rationale

100%

Rate limiting not skipped

100%

Without context: $0.5088 · 5m 14s · 26 turns · 31 in / 8,737 out tokens

With context: $0.4408 · 3m 46s · 21 turns · 365 in / 7,298 out tokens

Repository: boisenoise/skills-collections
Commit: 5c5ae21

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

Table of Contents

E-Commerce Order Management API Platform Architecture API Consultation Securing a Public Weather Data 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.