← Explore all skills

OBSERVABILITY / Addy Osmani

Observability and instrumentation

Requires a definition of working before adding a log line, and a check that the telemetry itself is real.

“Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alerting. Use when shipping any feature that runs in production and you need evidence it works. Use when production issues are reported but you can't tell what happened from the available data.”

01 / THE REASONING

Why this made the selection.

  • Telemetry starts from the questions an on-call engineer will ask, not from adding logs.
  • Cardinality and symptom-based alerts are called out as the failure modes.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/observability-and-instrumentation/SKILL.md
  • references/observability-checklist.md
  • LICENSE
  • README.md (installation command audit at the existing pin)

Our findings

  • The pinned skill requires two to four on-call questions before any log line, and it maps each question to a structured log, a metric, or a trace.
  • RED metrics are requested on every endpoint and external dependency, with histograms rather than averages.
  • Tracing uses OpenTelemetry, with manual spans only around meaningful internal work and context propagated across async boundaries.
  • Alerts must be actionable and link to a runbook, and the verification section says to confirm the telemetry in staging rather than assume it.
  • The guide separately records run identity and initiating path so later attribution does not depend on reconstructing unrelated scheduler or process history.

Not established by this review

  • The skill was not executed inside a host agent.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add addyosmani/agent-skills/skills/observability-and-instrumentation --skill observability-and-instrumentation

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills@1.7.1 add https://github.com/addyosmani/agent-skills/tree/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation --skill observability-and-instrumentation
  1. Choose your AI tools and project or global installation scope in Skills CLI. The review applies to the source revision shown on this page.
  2. Retain all supporting files; separately configure companion skills, runtimes and service credentials named in the definition.
  3. Review the resulting diff and use an isolated target before any migration, deployment, load test or warehouse operation.

Before you start

  • A development/staging service, selected telemetry SDK/backend and authorization for any alert test or external data export.

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. Skill definition ↗Checked

    https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation/SKILL.md

    Supports: Workflow and stated scope

  2. Repository licence ↗Checked

    https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/LICENSE

    Supports: Redistribution terms

  3. Install instructions ↗Checked

    https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/README.md

    Supports: Documented install path

  4. https://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation/SKILL.md

    Supports: bestFor, review

  5. https://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/README.md

    Supports: review

Evidence & Ask