Free Lesson

Design an API Product with Agent Skills

Hosted by Emmanuel Paraskakis

Wed, May 27, 2026

4:00 PM UTC (45 minutes)

Virtual (Zoom)

Free to join

119 students

Invite your network

Go deeper with a course

Build an API-First Product with AI
Emmanuel Paraskakis
View syllabus

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

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

I’m Emmanuel, 3x VP Product, now a founder at Level 250.

If you built or used APIs in the past 15 years, chances are you’ve used one of my products:

I’ve led some of the most influential API tools: Apiary (550,000+ APIs), Swagger (750,000+ APIs) and Oracle’s first Cloud-Native API Gateway. Before that, I built large B2B API programs at Verisk, Moody’s, and Precisely.

Today, I advise Fortune 500 CEOs and AI-forward startup founders on API Strategy, Developer Experience, MCP products, and AI agent readiness.

I'm also a member of OpenAPI and a featured speaker at apidays and other global technology conferences.

My passion is helping others build products, which is why I also teach on Maven: to share my lessons learned and help Product Managers and Engineers fast-track their careers.

Previously at

Verisk
Moodys
Oracle
SmartBear
Precisely
See all products from Emmanuel

Sign up to join this lesson

By continuing, you agree to Maven's Terms and Privacy Policy.