observability

Add structured decision logs and durable failure state to unattended code.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/vh2224/forge-executor --skill observability-vh2224
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/vh2224/forge-executor/tree/main/src/resources/skills/observability
Command: npx skills add https://github.com/vh2224/forge-executor --skill observability-vh2224

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you add the right diagnostic signals to code that runs unattended, so future agents can understand failures without rerunning the system or guessing from vague logs.

Core Features & Use Cases

  • Decision-point logging: Capture structured events at the exact moments a system chooses, retries, dispatches, or skips work.
  • Durable failure state: Persist the reason for a crash or degraded state so a fresh agent can inspect what went wrong after restart.
  • Health and status surfaces: Expose lightweight status endpoints or files for long-running jobs, servers, and background workers.
  • Explicit error handling: Replace silent catches and swallowed exceptions with clear failure modes that are easy to trace and alert on.

Quick Start

Add observability to the subsystem by mapping its failure modes, instrumenting the key decision points, persisting errors to durable storage, and exposing a simple health view for the next agent.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I add observability to background jobs and unattended processes?

Adding observability to background jobs requires capturing structured decision logs at key moments, persisting failure state to durable storage, and exposing health surfaces so a fresh agent can inspect what happened after a restart.

What is durable failure state and when do I need it for long-running servers?

Durable failure state is persisted crash or degraded state data needed for long-running servers, allowing a fresh agent to inspect what went wrong after a restart without rerunning or guessing from vague logs.

How do I stop silent error swallowing in auto-mode workflows?

To stop silent error swallowing in auto-mode workflows, replace silent catches and swallowed exceptions with explicit error handling paths that produce clear, traceable failure modes easy to alert on.

What's the best way to capture structured decision logs for watchers?

The best way to capture structured decision logs for watchers is instrumenting the exact moments a system chooses, retries, dispatches, or skips work, ensuring future agents can understand failures without guessing.

Does this approach to diagnostics work for code that runs unattended after a restart?

Yes, this diagnostics approach works for unattended code after a restart by persisting errors to durable storage and exposing simple health views, so a fresh reader can understand exactly what happened.

Why do I need health or status surfaces for background workers?

You need health or status surfaces for background workers to expose lightweight status endpoints or files, making long-running jobs diagnosable and allowing agents to understand failures without rerunning the system.