API Contract Generator Skill for Contract-First Endpoints
Turn a resource proposal into explicit OpenAPI inputs, response states, and examples both clients and servers can verify.
中文Install in Claude Code
Use your API proposal and OpenAPI tooling. The example uses synthetic checklist templates.
- Get the complete `plugins/api-development/api-contract-generator/skills/generating-api-contracts` directory from the pinned GitHub commit.
- Copy it into the target project's `.claude/skills/`. Check `.claude/skills/generating-api-contracts/SKILL.md`, start Claude Code at the project root, and call `/generating-api-contracts`.
Example task
Define POST /templates with required name and optional description. Write 201 id/name and 400 empty-name examples, then validate both.What to check
The contract gives frontend and backend teams two concrete fixtures and testable acceptance conditions.
Original SKILL.md on GitHub · Updated
Frequently asked question
Can one generic response schema cover every status?
Use separate schemas where response shapes differ and put shared error fields in a reusable component.