API And Interface Design
Projektowanie interfejsów REST/GraphQL i TypeScript według checklisty, z regułami błędów i nazewnictwa
Testowano · Działa
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 semanticsDefine the TypeScript contract between the frontend and this new serviceReview this public API change for additive-only compatibility