openapi-spec-generation

Quick Review

Excellent skill for OpenAPI spec generation with comprehensive templates covering design-first, code-first (FastAPI, TypeScript/tsoa), validation, and SDK generation. The description clearly communicates when to use the skill, and task knowledge is thorough with working code examples, validation rulesets, and practical patterns. Structure is good with clear sections, though a multi-file approach could further organize the extensive templates. Novelty is moderate-to-good: while OpenAPI generation tools exist, this skill consolidates best practices, multiple language approaches, and validation patterns that would otherwise require significant research and token usage by a CLI agent. The complete examples with proper error handling, pagination, security schemes, and linting configurations provide immediate production-ready patterns.