API Designer

Designar REST- eller GraphQL-API:er med resursmodeller, versionshantering och felstandarder.

av Jeffallan · Jeffallan/claude-skills

Fungerar med konfiguration ★ 7.2/10

API Designer — Designar REST- eller GraphQL-API:er med resursmodeller, versionshantering och felstandarder.

Vad den gör

Använd vid design av REST- eller GraphQL-API:er, skapande av OpenAPI-specifikationer eller planering av API-arkitektur. Anropa för resursmodellering, versioneringsstrategier, pagineringsmönster och standarder för felhantering.

Testrapport

Installerades ord för ord (målet omdirigerat till arbetskatalogen): SKILL.md-frontmatter är strikt YAML-giltig och alla fem referensfiler (rest-patterns, versioning, pagination, error-handling, openapi) finns och är substantiella. På en designuppgift för ett Bookmarks REST-API gav skillen ett korrekt, komplett resultat — rena substantiv-URI:er, cursor-paginering med motivering, giltig OpenAPI 3.1 och ett RFC 7807-fel. A/B mot den skillfria baslinjen slutade oavgjort: båda uppfyllde varje krav med i princip samma kvalitet, så skillen tillför solida skyddsräcken men ingen omvälvande förbättring här.

Testad: 2026-07-12 · Claude Code 2.x (agent harness)

Installation

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

Kommandon och exempelprompter

  • /api-designerDesignar REST- eller GraphQL-API:er med resursmodeller, versionshantering och felstandarder.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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