monitoring-apis

The monitoring-apis skill is designed to assist teams in building and documenting real-time API monitoring dashboards that focus on health, performance, and operational visibility. It addresses the common challenge of tracking API behavior across environments by providing structured guidance for defining metrics, alerts, and health checks tied to existing API specifications. By leveraging documented API designs and established development workflows, the skill helps ensure that monitoring capabilities are aligned with actual endpoints, data models, and authentication requirements rather than being added as an afterthought.

This skill supports a structured workflow that begins with reviewing existing API specifications and proceeds through defining resources, endpoints, schemas, and error-handling strategies. It enables generation of boilerplate scaffolding using predefined Bash tools and guides the implementation of handlers, validation, authentication, and database integration. Outputs are organized into conventional project directories for routes, controllers, models, middleware, and configuration, and culminate in a complete OpenAPI 3.0 specification. The skill emphasizes consistency, maintainability, and test coverage by including steps for integration testing and by referencing centralized documentation for implementation details, errors, and examples.

Typical use cases include teams that need to monitor API health and performance in production or staging environments, developers adding metrics and alerts to existing services, and organizations standardizing how monitoring dashboards are built across multiple APIs. The target users are backend developers, platform engineers, and technical teams working with Node.js, Python, Java, or Go frameworks who already have defined API requirements and want a repeatable approach to monitoring setup. The skill is most effective in environments where API specifications, authentication strategies, and testing tools are already in place.