API Design Principles

Aplikuje principy návrhu REST a GraphQL API pro tvorbu přehledných, škálovatelných API.

od wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Aplikuje principy návrhu REST a GraphQL API pro tvorbu přehledných, škálovatelných API.

Co umí

Osvojte si principy návrhu REST a GraphQL API pro tvorbu intuitivních, škálovatelných a udržovatelných API, ze kterých budou vývojáři nadšení. Použijte při návrhu nových API, revizi API specifikací nebo stanovování standardů pro návrh API.

Testovací report

Otestováno na úloze návrhu REST API (bookmarkovací služba: endpointy, verzování, stránkování, ukázky JSON) se skillem i bez něj. Obě větve vyprodukovaly korektní, kompletní návrhy s endpointy orientovanými na zdroje a verzováním v URL; běh se skillem plně odpovídal best practices, ale zvolil stránkování přes offset/page, zatímco základní běh nezávisle dospěl k silnější volbě založené na kurzoru s přesnějším zdůvodněním. Doslovná instalace i frontmatter byly v pořádku; skill nepřináší měřitelný přínos oproti schopnému základnímu modelu na této úloze.

Testováno: 2026-07-11 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /api-design-principlesAplikuje principy návrhu REST a GraphQL API pro tvorbu přehledných, škálovatelných API.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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