Staging environment
Free Lesson

Design an API Product with Agent Skills

Part of The Agent-Powered Super IC

45 min
May 27, 2026 12:00 PM
Virtual (Zoom)

In this video

What you'll learn

Build a complete, standards-based API design in 30 minutes

We'll take you from an idea to a complete, highly usable API spec ready for prototyping or building.

Install and use the API Design Skill in Claude Code

Complete process: User Stories→API Spec→Hill Climb to a high score→Preview Swagger Docs.

Understand how markdown context files work for high quality

Dive into the 4 markdown files you'll use as input: Requirements, Domain Model, API Standards, OpenAPI best practices.

Learn the importance of hill-climbing to get higher quality

Demonstrate the use of an OpenAPI linter and use the output to iteratively improve API quality up to 100%.

Take the Skill back to your organization and adapt it

Distribute it to every PM on your team (yes, agents too) and ensure high quality API design that checks all the boxes.

Why this topic matters

Can we make AI do API Design for us? Reliably? Like the best architect on the team? I built a Claude Code Skill just for that. It generates a complete API spec and lints it automatically for quality.
You stay in the loop where it matters: the design decisions. AI handles the 1000-line JSON file nobody wants to type. In this session, I'll show you how it works and we'll run it together, hands-on.

You'll learn from

Emmanuel Paraskakis

Emmanuel Paraskakis

3x VP Product (Apiary, Swagger, Oracle) | 1.3M APIs | Founder, Level 250 | Agent-ready APIs & MCP

Verisk
Moodys
Oracle
SmartBear
Precisely

Previously at

Verisk
Moodys
Oracle
SmartBear
Precisely
See all products from Emmanuel