API Designer

Designer REST- eller GraphQL-API-er med ressursmodeller, versjonering og feilstandarder.

av Jeffallan · Jeffallan/claude-skills

Krever oppsett ★ 7.2/10

API Designer — Designer REST- eller GraphQL-API-er med ressursmodeller, versjonering og feilstandarder.

Hva den gjør

Bruk ved design av REST- eller GraphQL-API-er, opprettelse av OpenAPI-spesifikasjoner, eller planlegging av API-arkitektur. Kall på for ressursmodellering, versjoneringsstrategier, pagineringsmønstre, feilhåndteringsstandarder.

Testrapport

Installert ordrett (mål omdirigert til workdir): SKILL.md-frontmatter er strict-YAML-gyldig, og alle fem referansefiler (rest-patterns, versioning, pagination, error-handling, openapi) er til stede og substansielle. På en Bookmarks REST API-designoppgave ga skillet et korrekt, komplett resultat — kun substantiv-URI-er, cursor-paginering med begrunnelse, gyldig OpenAPI 3.1, og en RFC 7807-feil. A/B mot no-skill-basearmen var uavgjort: begge dekket alle krav med i praksis lik kvalitet, så skillet gir solide sikringsmekanismer, men ingen transformativ løft her.

Testet på: 2026-07-12 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /api-designerDesigner REST- eller GraphQL-API-er med ressursmodeller, versjonering og feilstandarder.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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