API Designer

Designer REST- eller GraphQL-API'er med ressourcemodeller, versionering og fejlstandarder.

Af Jeffallan · Jeffallan/claude-skills

Virker med opsætning ★ 7.2/10

API Designer — Designer REST- eller GraphQL-API'er med ressourcemodeller, versionering og fejlstandarder.

Hvad det gør

Brug det, når du designer REST- eller GraphQL-API'er, opretter OpenAPI-specifikationer eller planlægger API-arkitektur. Kald det til ressourcemodellering, versioneringsstrategier, pagineringsmønstre og standarder for fejlhåndtering.

Testrapport

Installeret ordret (target omdirigeret til workdir): SKILL.md-frontmatter er strict-YAML-valid, og alle fem referencefiler (rest-patterns, versioning, pagination, error-handling, openapi) er til stede og substantielle. På en design-opgave for en Bookmarks REST-API producerede skillet et korrekt, komplet resultat — rene navneord i URI'er, cursor-paginering med begrundelse, gyldig OpenAPI 3.1 og en RFC 7807-fejl. A/B mod no-skill-basisarmen endte uafgjort: begge opfyldte alle krav på stort set samme niveau, så skillet tilføjer solide gelændere, men ingen transformativ forbedring her.

Testet: 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

Kommandoer og eksempelprompter

  • /api-designerDesigner REST- eller GraphQL-API'er med ressourcemodeller, versionering og fejlstandarder.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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