api-spec-analyzer

The API Specification Analyzer is a specialized engineering tool designed for developers working within the caremaster-tenant-frontend project. It bridges the gap between raw OpenAPI documentation and functional code by programmatically interpreting API schemas to deliver actionable, production-ready outputs. This skill is intended for software engineers, frontend developers, and full-stack contributors who need to accelerate API integration, ensure strict type safety, and maintain consistent communication between frontend services and backend RESTful endpoints.

Key features and capabilities include:

• Intelligent fetching and refreshing of project OpenAPI specifications using dedicated MCP tools.
• Automated generation of robust TypeScript interfaces, including complex nested objects, enum constraints, and required field validation.
• Production-grade code scaffolding for common patterns, including Fetch API services, TanStack Query hooks, and optimized query key management.
• Systematic analysis of HTTP methods, path parameters, query strings, and request/response body schemas.
• Structured documentation of security requirements, including Bearer token authentication, input validation strategies, and error handling for standard HTTP status codes like 400, 401, 404, and 500.

Practical usage notes:

• Trigger this skill whenever you are tasked with implementing a new feature involving backend communication, replacing mock data with real API calls, or debugging type mismatches.
• The analyzer is highly sensitive to endpoint mentions; if you reference /api/users or similar routes, it will automatically look up the relevant specification details.
• It provides specific test recommendations aligned with the API contract, helping you write unit tests for success and failure states (e.g., duplicate email conflict, unauthorized access).
• Ensure that you have the required MCP server connectivity active, as the skill relies on the Tenant Management Portal API tools to retrieve real-time documentation updates.
• The output is formatted in clear Markdown, making it easy to copy-paste generated types directly into your TypeScript source files, ensuring your frontend code remains perfectly synchronized with the evolving backend API contract.