generating-api-sdks

Quick Review

The skill has good structural organization with separated reference files, but suffers from significant misalignment between its stated purpose and implementation. The description claims it generates client SDKs from OpenAPI specs, but the instructions focus on building/implementing APIs themselves (routes, controllers, models). The actual SDK generation appears relegated to a single 'Bash(api:sdk-*)' command without clarity on what it does. For a CLI agent, the description would cause confusion about whether this skill builds APIs or generates client libraries. Task knowledge is moderate - it provides a reasonable workflow for API development but lacks SDK-generation specifics like language selection, output formats, or how OpenAPI specs are consumed. Structure is the strongest dimension with clear sections and proper use of reference files. Novelty is limited since SDK generation from OpenAPI is well-handled by existing tools (openapi-generator, swagger-codegen), and the skill doesn't clearly articulate what unique value it adds beyond wrapping these tools.