This article introduces `@asnd/skill-creator`, a TypeScript CLI designed to convert API surfaces (OpenAPI, GraphQL, MCP) into reusable skills for AI agents. It aims to reduce context waste by enabling coding agents to automate setup work and create durable tools instead of repeatedly parsing documentation.
This article explores how OpenAPI/Swagger specifications can serve as a single source of truth for automating API documentation with AI. It emphasizes preventing errors and ensuring consistency by automatically updating code snippets and descriptions.
MCP aims to standardize software access for AI agents, similar to how REST APIs did for human developers. The shift from human developers to LLM-driven agents as callers necessitates an adapted interface, with MCP serving as the universal, machine-readable description for agent APIs.