A reflective take on the excitement and skepticism that comes with new API specifications. Drawing on experience with Swagger, OpenAPI, AsyncAPI, and now emerging specs like MCP, Agent Skills, and JSON Structure, the author explores the tension between enthusiasm for new standards and the long-term realities of maintaining them. The author commits to a specification-agnostic stance, supporting and critically evaluating all specs rather than championing any single one, while noting that AI is shifting value extraction to the specification layer.
Table of contents
The Promise of a New Specification341 Impressions