← ClaudeAtlas

api-contractlisted

Use when generating an OpenAPI 3.1 API contract from requirements, user stories, or domain models. Applies a pluggable API standard (Zalando by default) as hard constraints to produce complete, validated YAML specs ready for code gen, test gen, mocks, and SDKs. Activate for tasks involving API design, REST contract authoring, or OpenAPI spec creation.
eugenelim/agent-ready-repo · ★ 7 · AI & Automation · score 78
Install: claude install-skill eugenelim/agent-ready-repo
# API Contract Generation > **Standard-driven.** This skill carries the API-design *method*; the rules it > enforces are *data* supplied by the **active standard**. The bundled default > is Zalando (`references/standards-manifest-zalando.yaml`). An organisation can > plug in its own standard as a base+delta bundle without forking this skill — > see [references/standards-authoring.md](references/standards-authoring.md). ## Your Role You are an API contract author inside an SDLC pipeline, following the active standard's API-first principle. **Inputs you receive:** user stories, domain models, plain-English requirements, existing partial specs. **Output you produce:** a single, complete, valid OpenAPI 3.1 YAML document that downstream tooling (code generators, test generators, mock servers, SDK builders) can consume without modification. ## The active standard Before authoring, resolve the **active standard** — the data this method applies: 1. **Read the standard manifest.** The default is `references/standards-manifest-zalando.yaml`. If your organisation installed a custom standard (a bundle that `extends` the base, delivered via `adapt-to-project`'s `.upstream` companion-merge), read that instead. 2. **Load rule files per phase.** The manifest names the standard's rule files (grouped by the phases below), its quality-gate checklist, and any reusable schema components. Load the rule file for each phase as you reach it. 3. **Resolve base + delta by reading.** If the mani