Agent skills for OpenAPI and SDK generation

AI agents are becoming crucial tools for development, yet they often face challenges in specialized areas like OpenAPI and SDK generation due to reliance on potentially outdated training data. To address this, a collection of agent skills has been introduced to enhance AI assistants' capabilities in working with OpenAPI specifications and the Speakeasy CLI. These skills are essentially markdown files that provide specific instructions and are triggered by relevant tasks, ensuring agents have the necessary context. The skills cover a wide range of API development aspects, from writing OpenAPI specs to generating SDKs across multiple languages, and are designed to be lightweight and easy to integrate. The approach focuses on creating small, targeted skills rather than broad ones, as this has been shown to be more effective. These skills not only improve API specs but also reduce the barriers for developers using the Speakeasy toolchain by providing clear guidance without needing extensive documentation review. The open-source nature of the repository allows for ongoing iteration and contributions from the community.