migrating-apis

Quick Review

The skill has good structure with separated reference files and a clear overview, but suffers from a significant mismatch between its stated purpose (API migration between versions/platforms) and its actual content (building new APIs from scratch). The description promises migration capabilities with minimal downtime, version upgrades, and platform transitions, yet the instructions focus on creating new API endpoints, defining schemas, and generating boilerplate—tasks for greenfield development rather than migration. The taskKnowledge is moderate as it provides a reasonable workflow for API development but lacks migration-specific guidance like versioning strategies, backward compatibility, deprecation paths, traffic routing, or rollback procedures. The structure is good with dedicated reference files for errors, examples, and implementation. Novelty is limited because the actual tasks described (scaffolding, validation, testing) are straightforward development activities that a CLI agent could handle without specialized tooling, though true migration work would be more complex.