observe

Defines product events, technical metrics, structured logs, and traces for operational observability.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/karenrebecag/spec-driven-standards --skill observe-karenrebecag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observe
Source: https://github.com/karenrebecag/spec-driven-standards/tree/main/plugins/reliability/skills/observe
Command: npx skills add https://github.com/karenrebecag/spec-driven-standards --skill observe-karenrebecag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When something breaks in production, teams often have no instrumentation in place and must guess at the cause. This Skill designs the observability layer up front — what to measure, where to instrument it, and which queries answer operational questions — so incidents are resolved with a query instead of speculation. ## Core Features & Use Cases - Four-layer instrumentation design: Covers product events (signup, checkout, activation), technical metrics (latency, error rate, throughput, saturation), structured JSON logs with request context, and distributed traces across services. - Question-driven instrumentation: Every event, metric, log, or trace must answer a concrete operational question, preventing useless telemetry. - Baseline query authoring: Produces the queries that show system health and the most likely failure modes, feeding into production-readiness reviews and incident response. - Use Case: Before shipping a new checkout flow, invoke this Skill to define the activation events, golden-signal metrics, error-path logs, and trace spans needed, plus the queries to monitor them after launch. ## Quick Start Invoke /observe to design the instrumentation and operational queries for the change you are about to ship.

Frequently Asked Questions about observe

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

FAQPage Schema
How do I design observability instrumentation before shipping a feature?

Invoke /observe to name the events, metrics, logs, and traces the change needs, each tied to a specific operational question. The Skill outputs what to instrument, where, and the baseline queries to read it.

What are the four golden signals for monitoring?

The four golden signals are latency, error rate, throughput, and saturation. This Skill uses them as the technical metrics layer, alongside product events, structured logs, and traces.

How do I structure logs for production debugging?

Use structured JSON logs with context fields like request id, user id, and route instead of loose console.log statements. Prioritize instrumenting error paths first, since those are what you query during incidents.

Does this Skill implement the instrumentation code?

No. It designs what to instrument and the queries to read it; implementation goes through the /ship workflow. Dashboard and alert configuration changes go through pull requests in read-only mode by default.

When should I use distributed tracing versus metrics?

Use traces to follow a single request across services and locate where time is spent; use metrics for aggregate health signals like latency and error rate. The Skill treats them as complementary layers answering different questions.