obs_baseline

Applies structured logging, metrics, tracing, and health check standards to new features and DevOps pipelines.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Vimurai/ai-os --skill obs-baseline-vimurai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obs_baseline
Source: https://github.com/Vimurai/ai-os/tree/main/.claude/skills/obs_baseline
Command: npx skills add https://github.com/Vimurai/ai-os --skill obs-baseline-vimurai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often ship features with inconsistent or missing observability, making production issues hard to diagnose and debug. This Skill enforces a consistent baseline for logging, metrics, tracing, and health checks so every service is diagnosable from day one. ## Core Features & Use Cases - Structured Logging Standards: Enforces JSON or key=value log formats with required fields like timestamp, level, and trace_id, while blocking secrets and PII from logs. - Metrics & Tracing Guidance: Defines minimum instrumentation for latency percentiles, error rates, and distributed trace propagation across service boundaries. - Health Check & CI Visibility Rules: Standardizes health endpoints for CLIs and servers, plus machine-readable test results and versioned build artifacts. - Use Case: When implementing a new API endpoint, apply this Skill to ensure the code emits structured logs with trace context, records p95 latency metrics, and exposes a compliant /health endpoint. ## Quick Start Apply the observability baseline standards to the new feature I am implementing, including structured logging, metrics, and a health check.

Frequently Asked Questions about obs_baseline

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

FAQPage Schema
How do I add structured logging to a new service?▼

Use JSON or key=value log formats with required fields: timestamp, level, service or module name, message, and trace_id for distributed systems. Never log passwords, tokens, API keys, or PII, and make error messages actionable with context about what failed.

What metrics should I instrument for a new feature?▼

Instrument request or operation latency at p50, p95, and p99 percentiles, plus error rates broken down by type. If applicable, also track critical resource utilization such as queue depth or database connection counts.

How do I implement a health check endpoint?▼

For servers, expose GET /health returning HTTP 200 with {"status":"ok"} when healthy, or 503 with a reason when unhealthy. For CLIs, exit with code 0 when healthy and exit 1 with a reason when unhealthy.

When should I add distributed tracing to my service?▼

Add tracing when your system is distributed across multiple services. Propagate trace context across service boundaries and instrument trust boundaries such as external API calls, database queries, and queue publishes.

What data should never appear in application logs?▼

Never log passwords, tokens, API keys, or PII such as emails, names, or IDs that map to real people. Error logs should include context about what failed and the input shape, but not the sensitive values themselves.