API Designer

Ontwerpt REST- of GraphQL-API's met resourcemodellen, versiebeheer en foutstandaarden.

Door Jeffallan · Jeffallan/claude-skills

Werkt met setup ★ 7.2/10

API Designer — Ontwerpt REST- of GraphQL-API's met resourcemodellen, versiebeheer en foutstandaarden.

Wat het doet

Gebruik dit bij het ontwerpen van REST- of GraphQL-API's, het opstellen van OpenAPI-specificaties of het plannen van API-architectuur. Roep aan voor resourcemodellering, versioneringsstrategieën, paginatiepatronen en foutafhandelingsstandaarden.

Testrapport

Letterlijk geïnstalleerd (target omgeleid naar workdir): de frontmatter van SKILL.md is strict-YAML-geldig en alle vijf referentiebestanden (rest-patterns, versioning, pagination, error-handling, openapi) zijn aanwezig en substantieel. Op een ontwerptaak voor een Bookmarks REST-API leverde de skill een correct, compleet resultaat op — alleen-zelfstandignaamwoord-URI's, cursorpaginatie met onderbouwing, geldige OpenAPI 3.1, en een RFC 7807-fout. A/B tegen de no-skill-basisvariant was gelijkspel: beide voldeden aan alle eisen met vrijwel gelijke kwaliteit, dus de skill voegt solide guardrails toe maar geen doorslaggevende meerwaarde hier.

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

Installatie

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

Commando's en voorbeeldprompts

  • /api-designerOntwerpt REST- of GraphQL-API's met resourcemodellen, versiebeheer en foutstandaarden.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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