review-observability

Audit observability plans for completeness, actionability, consistency, and coverage gaps.

5|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/tomzx/agents --skill review-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-observability
Source: https://github.com/tomzx/agents/tree/main/skills/review-observability
Command: npx skills add https://github.com/tomzx/agents --skill review-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits an observability plan for completeness, actionability, consistency, and alignment with the specification and requirements.

Core Features & Use Cases

  • Identify and report findings across five categories: completeness, actionability, consistency, coverage gaps, and overlap with telemetry.
  • Cross-reference the observability plan with the specification and telemetry plan.
  • Produce a structured report and, when resolved, update status and append questions.

Quick Start

Review the provided observability document and cross-reference it with the specification, telemetry plan, and requirements.

Frequently Asked Questions about review-observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit an observability plan for completeness and coverage gaps?

To audit an observability plan, review it against system specifications and requirements to identify coverage gaps, consistency issues, and overlap with telemetry. This assessment evaluates logs, metrics, and alerts across five categories to ensure reliability and diagnosability.

What makes an observability plan actionable for software systems?

An actionable observability plan ensures logs, metrics, and alerts are complete, consistent, and cross-referenced with telemetry specifications. Evaluating actionability involves checking whether the telemetry data effectively surfaces issues and supports reliable system diagnosis.

How do I cross-reference a telemetry plan with system requirements?

Cross-referencing a telemetry plan involves comparing it against system specifications and requirements to surface coverage gaps and overlapping data. This process produces a structured report assessing completeness, actionability, and consistency across the observability strategy.

When should I review metrics and alerts for overlap with telemetry?

You should review metrics and alerts for telemetry overlap when assessing observability plan consistency. Identifying redundant telemetry helps resolve coverage gaps and ensures alerting mechanisms remain actionable without duplicating diagnostic data.

Can I update frontmatter status and append questions after reviewing an observability plan?

Yes, reviewing an observability plan includes updating the frontmatter status and appending questions as part of the workflow. This occurs when findings across completeness, actionability, consistency, and coverage gaps are resolved.