API And Interface Design

Projektowanie interfejsów REST/GraphQL i TypeScript według checklisty, z regułami błędów i nazewnictwa

Autor: addyosmani · addyosmani/agent-skills

Testowano · Działa ★ 9.6/10

API And Interface Design — Projektowanie interfejsów REST/GraphQL i TypeScript według checklisty, z regułami błędów i nazewnictwa

Co robi ten skill

Prowadzi przez projektowanie stabilnych endpointów REST/GraphQL, granic modułów i kontraktów typów TypeScript, opierając się na prawie Hyruma, spójnej semantyce błędów, walidacji na granicach i zmianach wyłącznie addytywnych. Uruchamia się, gdy użytkownik projektuje nowe endpointy, definiuje kontrakty między frontendem a backendem lub modułami, albo zmienia istniejący interfejs publiczny.

Raport z testu

Zamienił API oparte na czasownikach (POST /createBookmark, niespójne zwroty) w porządne trasy zasobowe, jeden spójny kształt błędu, paginację kursorową i markowany typ ID.

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

Instalacja

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

Komendy i przykładowe prompty

  • /api-and-interface-designProjektowanie interfejsów REST/GraphQL i TypeScript według checklisty, z regułami błędów i nazewnictwa

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 endpoint for order refunds with consistent error semantics
  • Define the TypeScript contract between the frontend and this new service
  • Review this public API change for additive-only compatibility