API Designer

Navrhuje REST nebo GraphQL API s modely zdrojů, verzováním a standardy pro chyby.

od Jeffallan · Jeffallan/claude-skills

Funguje s nastavením ★ 7.2/10

API Designer — Navrhuje REST nebo GraphQL API s modely zdrojů, verzováním a standardy pro chyby.

Co umí

Použijte při návrhu REST nebo GraphQL API, tvorbě specifikací OpenAPI nebo plánování architektury API. Vyvolejte pro modelování zdrojů, strategie verzování, vzory stránkování a standardy zpracování chyb.

Testovací report

Instalováno beze změn (cíl přesměrován do pracovního adresáře): frontmatter SKILL.md je striktně validní YAML a všech pět referenčních souborů (rest-patterns, versioning, pagination, error-handling, openapi) je přítomných a obsahově bohatých. Na úloze návrhu REST API pro Bookmarks skill dodal správný a kompletní výsledek — URI pouze s podstatnými jmény, stránkování pomocí kurzoru s odůvodněním, platné OpenAPI 3.1 a chybu podle RFC 7807. A/B proti variantě bez skillu skončilo nerozhodně: obě varianty splnily všechny požadavky v podstatě stejné kvalitě, takže skill přidává solidní mantinely, ale zde nepřináší zásadní zlepšení.

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

Instalace

git clone https://github.com/Jeffallan/claude-skills
cd claude-skills
mkdir -p ~/.claude/skills
cp -r skills/api-designer ~/.claude/skills/api-designer

Příkazy a ukázkové prompty

  • /api-designerNavrhuje REST nebo GraphQL API s modely zdrojů, verzováním a standardy pro chyby.

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

  • Design a REST API for this new service
  • Write an OpenAPI spec for these endpoints
  • Plan pagination and error handling for this API