Api Integration skills for AI agents

Craft clear, accurate, and user-friendly API documentation that empowers developers to integrate with your services quickly and efficiently. This skill covers structuring content, providing executable examples, and maintaining accuracy. Activate this skill when you are designing or updating documentation for a new or existing API, or when seeking to improve developer experience and adoption.

Architect and implement robust API Gateway patterns to manage, secure, and scale your microservices APIs effectively. This skill guides you through crucial patterns like BFF, API Composition, and Caching, enabling you to optimize client-server interactions and enhance operational resilience. Activate this skill when designing a new API architecture, optimizing an existing microservices gateway, or addressing challenges related to API security, performance, or service orchestration.

Effectively implement and manage robust API monitoring strategies to ensure the availability, performance, and correctness of your API integrations. This skill guides you through proactive detection, deep diagnostics, and actionable alerting across your API ecosystem. Activate this skill when designing new API architectures, troubleshooting existing integrations, or optimizing the reliability and user experience of your services.

Master strategies for interacting with external APIs while respecting their rate limits, ensuring your applications remain compliant and robust. This skill teaches you how to prevent `429 Too Many Requests` errors, implement intelligent retry mechanisms, and optimize your API consumption. Activate this skill when you are integrating with third-party APIs, designing resilient data pipelines, or troubleshooting connection stability issues due to excessive requests.

Master the principles and practices for securing your APIs against common threats, ensuring data integrity, confidentiality, and availability. This skill guides you in implementing robust authentication, authorization, and data protection mechanisms. Activate this skill whenever you are designing, developing, or auditing an API, or when assessing potential vulnerabilities in existing integrations.

Master the comprehensive validation of API functionality, reliability, performance, and security. This skill covers strategic approaches to ensure your APIs consistently meet their contractual obligations and provide a robust integration experience. Activate this skill when developing new APIs, integrating third-party services, diagnosing API issues, or establishing continuous quality assurance for your microservices.

Strategically manage the evolution of your APIs to introduce new features, refactor endpoints, and deprecate old functionality without breaking existing client integrations. This skill teaches various versioning strategies and how to apply them to maintain stability and foster long-term API adoption. Activate this skill whenever you plan to make non-backward-compatible changes to an API, need to support multiple client versions, or are defining your API's lifecycle management.

Design and implement robust, informative, and developer-friendly error handling mechanisms for APIs. This skill teaches you how to craft predictable error responses that empower API consumers to diagnose issues and build resilient integrations. Activate this skill when architecting new API endpoints, refactoring existing error responses, or troubleshooting common integration failures caused by unclear error communication.

Design robust, intuitive, and performant GraphQL schemas that empower clients to request precisely the data they need. This skill covers type system modeling, query and mutation design, and strategies for schema evolution. Activate this skill when you are architecting a new GraphQL API, refactoring an existing schema, or need guidance on evolving your API while maintaining backward compatibility.

Master the common interaction models, service design strategies, and robust error handling mechanisms essential for building high-performance, resilient gRPC services. This skill equips you to select the appropriate RPC style, manage stream lifecycles, and design idiomatic gRPC APIs. Activate this skill when architecting new gRPC-based microservices, refactoring existing gRPC endpoints, or integrating complex systems using Protocol Buffers.

Master the various OAuth 2.0 authorization flows to securely delegate access from a resource owner to a client application. This skill guides you in selecting the appropriate flow for different application types and implementing robust token management strategies. Activate this skill when designing or integrating with APIs requiring delegated authorization, securing client applications, or enhancing your understanding of modern authentication protocols.

Master the creation and interpretation of OpenAPI Specification documents to design, document, and automate your API workflows. This skill teaches you to define robust API contracts, leverage tooling for code generation and validation, and foster seamless integration across development teams. Activate this skill when you are architecting a new RESTful API, documenting an existing one, or integrating with external services using their OpenAPI definitions.

Design robust, scalable, and developer-friendly RESTful APIs that adhere to industry best practices and architectural principles. This skill covers resource modeling, HTTP method usage, versioning strategies, error handling, and security considerations. Activate this skill when you are planning a new API, reviewing an existing API's architecture, or need guidance on evolving an API for future needs.

Design intuitive, robust, and idiomatic SDKs that abstract API complexity and accelerate developer integration. This skill focuses on language-specific conventions, comprehensive error handling, and lifecycle management for seamless API consumption. Activate this skill when you are architecting a new client library, refactoring an existing SDK, or need to provide guidance on best practices for API consumers.

Master the design, implementation, and management of robust webhook systems for real-time, event-driven communication. This skill covers secure payload design, reliable delivery mechanisms, and best practices for integrating services asynchronously. Activate this skill when you are architecting event-driven APIs, integrating with third-party platforms, or building reactive, decoupled microservices.

Design robust, scalable, and efficient real-time communication systems using WebSockets. This skill covers message protocol design, connection management, and strategies for scaling persistent connections. Activate this skill when you are architecting new real-time features, improving existing WebSocket implementations, or need guidance on building high-performance, bi-directional communication channels.