generating-api-contracts

Quick Review

The skill is well-structured with clear separation of concerns (implementation, errors, examples in separate files). However, the description and core task focus are misaligned: the description promises 'Generate API contracts and OpenAPI specifications from code or design documents' but the instructions primarily describe building API implementations (routes, controllers, models, middleware). The skill conflates API contract/spec generation with full API development. Task knowledge is moderate - it provides frameworks and general steps, but lacks specifics on extracting contracts from existing code or translating design docs to OpenAPI specs. Novelty is limited as generating OpenAPI specs is well-supported by existing tools (swagger-jsdoc, fastapi auto-docs, springdoc) that a CLI agent could invoke directly. The skill would benefit from focusing specifically on contract generation/documentation rather than full API implementation.