SkillProof tested Claude skills

API Designer

Projektuje API REST albo GraphQL z modelami zasobów, wersjonowaniem i standardami błędów.

Autor: Jeffallan · Jeffallan/claude-skills

Działa po konfiguracji ★ 7.2/10

API Designer — Projektuje API REST albo GraphQL z modelami zasobów, wersjonowaniem i standardami błędów.

Co robi ten skill

Używaj przy projektowaniu API REST albo GraphQL, tworzeniu specyfikacji OpenAPI albo planowaniu architektury API. Wywołuj do modelowania zasobów, strategii wersjonowania, wzorców paginacji, standardów obsługi błędów.

Raport z testu

Zainstalowany dosłownie (cel przekierowany do katalogu roboczego): frontmatter SKILL.md jest poprawnym strict-YAML, a wszystkich pięć plików referencyjnych (rest-patterns, versioning, pagination, error-handling, openapi) jest obecnych i treściwych. Na zadaniu projektowania REST API dla Bookmarks skill dał poprawny, kompletny wynik — URI wyłącznie rzeczownikowe, paginacja kursorowa z uzasadnieniem, poprawne OpenAPI 3.1 i błąd RFC 7807. A/B względem wariantu bez skilla wyszło na remis: oba spełniły każdy wymóg na zasadniczo równym poziomie, więc skill dodaje solidne ramy, ale nie daje tu przełomowej przewagi.

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

Instalacja

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

Komendy i przykładowe prompty

  • /api-designerProjektuje API REST albo GraphQL z modelami zasobów, wersjonowaniem i standardami błędów.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →