API Design Patterns

38 zasad nazewnictwa endpointów REST, błędów, paginacji, wersjonowania i bezpieczeństwa API.

Autor: AsyrafHussin · AsyrafHussin/agent-skills

Testowano · Działa ★ 9.6/10

API Design Patterns — 38 zasad nazewnictwa endpointów REST, błędów, paginacji, wersjonowania i bezpieczeństwa API.

Co robi ten skill

Skondensowany zbiór zasad (38 zasad / 7 kategorii) dla projektowania API RESTful, obejmujący nazewnictwo zasobów, kształt odpowiedzi błędów, paginację, wersjonowanie i uwierzytelnianie. Uruchamia się podczas projektowania lub przeglądania endpointów, lub pisania kodu obsługi błędów/paginacji, i odwołuje się do plików dla poszczególnych zasad (rules/*.md) oraz skompilowanego pliku AGENTS.md o długości 7200 linii dla głębszych analiz.

Raport z testu

Przeprowadzono przez nią rzeczywisty redesign 'invoices API': umiejętność zmieniła URL-e oparte na czasownikach (POST /createInvoice) w rzeczowniki właściwe, zastąpiła goły ciąg błędu ustrukturyzowaną kopertą (code/message/details/request_id) i dodała metadane paginacji kursorowej oraz linki HATEOAS, których naiwna wersja bazowa nigdy nie miała.

Testowano: 2026-07-14 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/AsyrafHussin/agent-skills
cd agent-skills
mkdir -p ~/.claude/skills
cp -r skills/api-design-patterns ~/.claude/skills/api-design-patterns

Komendy i przykładowe prompty

/api-design-patterns38 zasad nazewnictwa endpointów REST, błędów, paginacji, wersjonowania i bezpieczeństwa API.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Design a REST API for user management with proper error handling
Review my API endpoints for best practices before we ship
What HTTP status codes should I use for this validation error?

Pełny raport →