api-architect

What it does

This skill enables AI agents to design, structure, and document robust API architectures. It assists in defining endpoints, data models, and integration patterns to ensure scalable system communication.

When to use it

• Planning the initial blueprint for a new microservices or monolithic application.
• Defining standard endpoint schemas and request/response formats for team consistency.
• Documenting API contracts before development begins to prevent integration errors.
• Evaluating architectural patterns like REST, GraphQL, or gRPC for specific use cases.

Key capabilities

• API structure design and layout planning.
• Endpoint definition and routing logic creation.
• Data model specification and schema generation.
• Integration pattern recommendation and documentation drafting.

Example prompts

• "Design a RESTful API architecture for an e-commerce platform with user authentication and order processing."
• "Define the data models and endpoint schemas for a real-time chat application using WebSocket."
• "Create a high-level architectural diagram description for a payment gateway integration system."

Tips & gotchas

Ensure you provide context about your target audience (e.g., internal tools vs. public APIs) to get tailored security and scalability advice. While this skill outlines the architecture, it does not generate executable code or handle live server deployment configurations.