I built a Claude Code Skill that designs APIs for me.
(Not because I’m lazy. OK, maybe a little.)
Here’s what it does:
You give it your requirements, domain model, and API standards.
It generates user stories for you to review — the design decisions. You adjust. “Nest that differently.” “We don’t need a DELETE.” “Add pagination.”
Then it generates a complete @OpenAPI spec. Lints it automatically with RateMyOpenAPI (thanks @Martyn Davies and the @Zuplo team for that gem). And iterates until the score hits 100.
The human stays in the loop where it matters: the design decisions. The AI handles the 1000-line JSON file nobody wants to type.
I talked about this method at @Developer Week a few weeks ago. Shoutout to Erik Wilde for putting together an incredible API track. The conference example is in the repo if you want to see the full inputs and outputs.
It’s open source. MIT license. Free.
-> https://github.com/paraskakis/skills
I’ll use these Skills as part of the updated API Product Mastery course starting on Thursday, so if you want to level up your API skills (in general, not just with agents) sign up today.