observability-stack

name	observability-stack
description	Sets up a full observability stack with instrumentation and dashboards for a service. Use when you want to add structured metrics collection and a pre-built dashboard to a new service so it is observable from day one.
x-spec-version	1

observability-stack (Skillset)

A coordinated set of skills that adds end-to-end observability to a service: metric instrumentation at the code level and a pre-built dashboard for visualising those metrics.

When to use

Use when you are onboarding a new service and need all of: structured metric collection, consistent naming, and a ready-to-use dashboard.

Individual member skills can be used independently — see each skill's "When to use" section.

Member skills

Install and apply in this order:

1. instrumentation — Adds metric collection stubs and exports to the service.
2. dashboards — Creates a pre-built monitoring dashboard wired to the metric names defined by instrumentation.

Shared parameters

Parameters shared across member skills are documented in PARAMETERS.md in this directory. Each member skill also maintains its own PARAMETERS.md for skill-specific parameters.

Instructions

1. Fill in all shared parameters in this directory's PARAMETERS.md.
2. Apply member skills in the order listed above.
3. Run each member skill's verification step before proceeding to the next.

Verification

After applying all member skills, run the quality gate for each member:

validate-skill.sh instrumentation
validate-skill.sh dashboards

Expected output: VALIDATION_RESULT: PASS for each member.