generating-api-contracts

Quick Review

The skill has good structural organization with references separated into dedicated files, and provides a reasonable workflow for API contract generation. However, the description is somewhat generic and doesn't clearly distinguish between 'generating contracts from code' vs 'from design documents' - two very different processes. The task knowledge section conflates API implementation (controllers, middleware, database integration) with contract generation, which should primarily focus on specification/documentation generation. The novelty is moderate - while contract generation tools exist, orchestrating the full workflow could save tokens, though a CLI agent could reasonably handle OpenAPI generation with existing tools. The allowed-tools definition (Bash api:contract-*) suggests custom tooling but lacks clarity on what these commands actually do. Stronger if it clearly separated contract extraction from code vs contract-first design, and focused less on implementation details.