OpenSkillIndex← back to search
claude-code

Skillshub common-observability

Standards for structured logging, distributed tracing, and metrics. (triggers: **/*.service.ts, **/*.handler.ts, **/*.middleware.ts, **/*.interceptor.ts, **/*.go, **/*.java, **/*.kt, **/*.py, logging, tracing, metrics, opentelemetry, observability, slo)

install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/HoangNguyen0403/agent-skills-standard/common-observability" ~/.claude/skills/comeonoliver-skillshub-common-observability && rm -rf "$T"
manifest: skills/HoangNguyen0403/agent-skills-standard/common-observability/SKILL.md
source content

Common Observability Standards

Priority: P1 (OPERATIONAL)

📋 Logging & Tracing

  • JSON Logs: Always emit JSON structured logs. Never plain-text in prod.
  • Correlation: Extract 
    X-Request-Id
    or 
    traceparent
    . Attach to async context.
  • Tracing: Use OpenTelemetry. Propagate W3C 
    traceparent
    .
  • Spans: Name spans like 
    <HTTP_METHOD> <route>
    (
    GET /users/:id
    ).

📊 Metrics

  • Required: Request rate, Error rate, Latency histogram (p50/p95/p99), Saturation.
  • SLOs: Alert on SLO burn rates, not raw threshold spikes.

🚫 Anti-Patterns

  • Console.log: Do not use in prod; use a structured logger (
    pino
    , 
    zap
    ).
  • PII in Logs: Never log tokens, passwords, or full request bodies.
  • Dynamic Span Names: 
    GET /users/123
    causes cardinality explosion. Use 
    GET /users/:id
    .
  • Missing Cleanup: Always end tracing spans.

References