rest-patterns

Quick reference for RESTful API design patterns, HTTP semantics, caching, and rate limiting. Triggers on: rest api, http methods, status codes, api design, endpoint design, api versioning, rate limiting, caching headers.

Install with Tessl CLI

npx tessl i github:NeverSight/skills_feed --skill rest-patterns

What are skills?

Review — 95%

Does it follow best practices?

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

100%

12%

Hotel Booking Platform API Design

REST resource URL and status code design

Criteria

Without context

With context

Noun-based URLs

100%

Correct HTTP methods

100%

201 for creation

100%

Location header on create

100%

204 for no-body responses

100%

422 for validation errors

60%

100%

Flat URL structure

50%

100%

Pagination on collections

70%

100%

Query param for filtering/sorting

100%

No 200 for errors

100%

404 for missing resources

100%

Without context: $0.2466 · 1m 23s · 10 turns · 56 in / 6,045 out tokens

With context: $0.4571 · 1m 55s · 20 turns · 28 in / 7,550 out tokens

90%

Patient Records API — Security Design

API security and authentication

Criteria

Without context

With context

OAuth/JWT recommendation

100%

401 vs 403 distinction

100%

no-store cache header

100%

Rate limiting per client

100%

429 for rate limit exceeded

100%

CORS configuration

100%

HTTPS/TLS required

100%

No sensitive data in URLs

100%

Input validation mentioned

Auth failure codes consistent

100%

Without context: $0.2320 · 1m 25s · 12 turns · 19 in / 4,006 out tokens

With context: $0.4262 · 1m 47s · 23 turns · 461 in / 5,316 out tokens

92%

25%

SaaS Analytics API — Implementation Review

Collection endpoints and input validation

Criteria

Without context

With context

Noun-based routes

100%

Correct method for delete

100%

Correct method for update

100%

Pagination on list endpoints

100%

201 for resource creation

100%

Location header on create

404 not 200 for missing resources

100%

204 for delete

100%

Input validation with 422

41%

100%

CHANGES.md documents REST fixes

100%

Without context: $0.2721 · 1m 15s · 13 turns · 18 in / 5,176 out tokens

With context: $0.5603 · 2m 3s · 27 turns · 64 in / 7,530 out tokens

Evaluated: about 14 hours ago
Agent: Claude Code

Table of Contents

Hotel Booking Platform API Design Patient Records API — Security Design SaaS Analytics API — Implementation Review

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.