openapi-spec-generator

Quick Review

The skill has clear structure and addresses a useful automation need (generating OpenAPI specs), but severely lacks concrete implementation details. The description is too generic and repetitive, providing no specific information about HOW it generates OpenAPI specs, what inputs it accepts (existing APIs, code, documentation?), what output formats it supports (OpenAPI 3.0/3.1, Swagger 2.0?), or what methods it uses. There are no actual steps, scripts, templates, or workflows provided for spec generation. While the concept has novelty value (automating OpenAPI spec creation could save tokens vs. manual generation), the skill as documented provides almost no actionable guidance beyond generic placeholders. To improve: add concrete workflows for different spec generation scenarios, include templates or parsers for common frameworks, provide validation steps, and clarify specific capabilities like endpoint discovery, schema inference, or annotation parsing.