api-patterns

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

1.16x

Quality

61%

Does it follow best practices?

Impact

99%

1.16x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/api-patterns/SKILL.md

Evaluation results

100%

35%

API Technology Selection for Two New Projects

API technology selection: tRPC vs GraphQL vs REST

Criteria

Without this skill

With this skill

tRPC for Project A

100%

Project A reasoning

100%

tRPC runtime validation

100%

GraphQL for Project B

100%

Project B reasoning

100%

GraphQL depth protection

100%

GraphQL complexity protection

100%

GraphQL batch protection

100%

Introspection as policy choice

100%

GraphQL schema evolution

100%

Task Management API Design

REST API design with OpenAPI spec for task management service

Criteria

Without this skill

With this skill

Noun-based paths

70%

100%

Plural resource forms

100%

Path depth within limit

100%

201 for resource creation

100%

204 for deletions

100%

422 for validation errors

50%

100%

Consistent response format

100%

Error code field

100%

Request ID in errors

100%

No internal error details exposed

100%

Cursor or keyset pagination

100%

Rate limiting in OpenAPI

60%

100%

Validator script run

100%

97%

-3%

Weather Forecast API: Authentication and Rate Limiting Specification

Auth and rate limiting spec for a public weather API

Criteria

Without this skill

With this skill

API Key auth

100%

OAuth 2.0 for users

100%

JWT single algorithm

100%

70%

JWT issuer and audience

100%

JWT short expiry + refresh

100%

JWT no sensitive data

100%

Token bucket algorithm

100%

X-RateLimit-Limit header

100%

X-RateLimit-Remaining header

100%

X-RateLimit-Reset header

100%

HTTP 429 status code

100%

requestId in errors

100%

No internal error details

100%

URI versioning

100%

Repository: sickn33/agentic-awesome-skills
Path: skills/api-patterns/SKILL.md
Commit: b1aebac

Evaluated: ~15 hours ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Task Management API Design API Technology Selection for Two New Projects Weather Forecast API: Authentication and Rate Limiting Specification

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.