API Design Principles

Stosuje zasady projektowania REST i GraphQL, by budować przejrzyste, skalowalne API.

Autor: wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Stosuje zasady projektowania REST i GraphQL, by budować przejrzyste, skalowalne API.

Co robi ten skill

Opanuj zasady projektowania API w REST i GraphQL, by tworzyć intuicyjne, skalowalne i łatwe w utrzymaniu API, które zachwycają deweloperów. Używaj przy projektowaniu nowych API, przeglądaniu specyfikacji API lub ustalaniu standardów projektowania API.

Raport z testu

Przetestowano zadanie projektowe REST (serwis do zakładek: endpointy, wersjonowanie, paginacja, przykłady JSON) z użyciem skilla i bez niego. Obie gałęzie dały poprawne, kompletne projekty z endpointami zorientowanymi na zasoby i wersjonowaniem w URL; gałąź ze skillem była w pełni zgodna z best practices, ale wybrała paginację offset/page, podczas gdy gałąź bazowa samodzielnie doszła do mocniejszego wyboru opartego na kursorach, z ostrzejszym uzasadnieniem. Instalacja weryfikowana dosłownie i frontmatter były czyste; skill nie daje mierzalnej przewagi nad sprawnym modelem bazowym w tym zadaniu.

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

Instalacja

git clone https://github.com/wshobson/agents
cd agents
mkdir -p ~/.claude/skills
cp -r plugins/backend-development/skills/api-design-principles ~/.claude/skills/api-design-principles

Komendy i przykładowe prompty

  • /api-design-principlesStosuje zasady projektowania REST i GraphQL, by budować przejrzyste, skalowalne API.

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

  • Review this REST API design for consistency issues
  • Design a GraphQL schema following best practices
  • Set API design standards for our new service