observability

Instrument code with structured logs, health endpoints, and persisted failure state.

12|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/qdzsh/gsd-revamp --skill observability-qdzsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/qdzsh/gsd-revamp/tree/main/src/resources/skills/observability
Command: npx skills add https://github.com/qdzsh/gsd-revamp --skill observability-qdzsh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing issues in codebases that lack visibility is hard. This skill provides a structured approach to adding agent-first observability, enabling you to read signals at 3am instead of re-running code.

Core Features & Use Cases

  • Structured logs at decision points, health endpoints for long-running processes, and persisted failure state for forensics.
  • Clear failure modes and health surfaces to support debugging, incident response, and refactoring.
  • Use Case: When refactoring a background service or building a server, instrument observability to maintain visibility and reliability.

Quick Start

Invoke observability instrumentation on a running subsystem to enable structured logs, health endpoints, and persisted failure state.

Frequently Asked Questions about observability

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

FAQPage Schema
What is the best way to debug a long-running server that lacks visibility?

The best way to debug a server lacking visibility is to implement agent-first observability by mapping explicit failure modes, adding decision-point logging, and creating health surfaces. This allows you to read signals directly during an incident instead of guessing.

Can I use structured logging for incident response on a subsystem undergoing refactoring?

Yes, you can use structured logging for incident response during refactoring by instrumenting decision points and persisting failure states. This maintains visibility and reliability, ensuring you can diagnose issues in the modified subsystem at any time.

Why do I need health endpoints in my observability strategy?

You need health endpoints in your observability strategy to provide clear health surfaces for long-running processes and servers. They expose explicit failure modes and system status, supporting immediate debugging and incident response without requiring direct process inspection.

How do I remove noisy instrumentation from my codebase?

To remove noisy instrumentation, apply a structured observability approach that includes explicit failure handling and the removal of unnecessary logging. This ensures only meaningful decision-point logs and health endpoints remain, reducing noise while maintaining diagnosability.

When do I need to persist failure state for debugging?

You need to persist failure state for debugging when managing long-running processes or background jobs where immediate forensics are required. Persisting the failure state captures explicit failure modes, allowing you to analyze issues after they occur without re-running the code.