Erst der Vertrag, dann der Handler — ohne Verhandlung.
Die Spec ist die Quelle, der Code folgt ihr: deklarierte Sicherheit, standardisierte Fehler, idempotente Schreibzugriffe, signierte Webhooks und Breaking Changes nur mit ADR und Datum.
$ schematize install apiUnverhandelbare Mindeststandards
Wird nie abgeschaltet, "um schneller zu sein". Vollständige Liste in der Skill.
Contract-first
Die Spec (OpenAPI 3.1+ oder .proto) ist die Quelle; Handler und Clients werden daraus erzeugt oder dagegen validiert, Drift blockiert die CI.
Sicherheit pro Operation deklariert
securitySchemes vorhanden und jede Operation abgedeckt; absichtlich öffentlich heißt explizit security: []; Token nie in der Query-String.
Fehler sind problem+json (RFC 9457)
Jede 4xx/5xx-Antwort trägt einen stabilen type; nie ein 200 mit Fehler im Body und nie Stacktrace oder SQL in detail.
POST mit Wirkung braucht Idempotency-Key
Auf den Principal begrenzt, mit Replay derselben Antwort und 422/409 bei Missbrauch.
Collections paginieren per opakem Cursor
Stabile Gesamtordnung und gedeckeltes Limit; Offset nur mit schriftlicher Begründung.
Signierte Webhooks mit Replay-Fenster
HMAC pro Endpoint, id und Timestamp, Retry mit Backoff und Jitter, DLQ, Anti-SSRF; Zustellung ist at-least-once, nie exactly-once.
Breaking Change nur mit ADR und Datum
Der Kompatibilitäts-Diff (oasdiff, buf breaking) läuft im PR; Deprecation heißt Deprecation + Sunset + Migrationslink und 410 am Stichtag.
Jedes Feld begrenzt, Geld als Ganzzahl
maxLength, maximum und maxItems bei jeder Eingabe; Geld ist eine Ganzzahl in der kleinsten Einheit + Währung, nie float.
Befehle
Installiert in .claude/commands/. Jederzeit /api-help ausführen.
/api-breakingKlassifiziert eine Vertragsänderung, führt den Kompatibilitäts-Diff aus und erstellt den datierten Deprecation-Plan./api-ccContext Compact: schreibt das Handoff ins Archive und führt /compact aus./api-claudeErstellt oder ergänzt die dauerhaft aktive CLAUDE.md mit dem API-Contract-Mindeststandard im Repo-Root (überschreibt keine Blöcke anderer Skills)./api-designEntwirft eine neue Ressource oder Operation contract-first, vor jedem Handler./api-handoffErzeugt das Kontext-Handoff (context.md + checklist.md) im Archive, ohne zu kompaktieren./api-helpListet alle Befehle und ihre Wirkung auf./api-loadLädt das gesamte Regelwerk zu API-Contract zwangsweise und wendet es in der Sitzung an./api-reviewPrüft eine OpenAPI-/.proto-Spec gegen den Mindeststandard: führt das Gate aus und liest, was die Maschine nicht liest./api-webhookEntwirft oder prüft ausgehende und eingehende Webhooks: Signatur, Replay, Retry, Dedupe und SSRF.Für KI-Agenten
Ohne menschliches Eingreifen installierbar. Metadaten in llms.txt.
- Ausführen: git clone https://github.com/schematizeme/skill-api.git && ./skill-api/install.sh
- Oder herunterladen: https://github.com/schematizeme/skill-api/releases/latest/download/skill-api.zip und nach .claude/skills/ entpacken
- Kopiere assets/CLAUDE.md in das Repo-Root (Immer-an-Regel).
- Bestätige mit /api-help.
Diskussion
Wird geladen…