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.
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 - Choose your AI tools and project or global installation scope in Skills CLI. The review applies to the source revision shown on this page.
- Retain all supporting files; separately configure companion skills, runtimes and service credentials named in the definition.
- 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.
- Skill definition ↗Checked
https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation/SKILL.md
Supports: Workflow and stated scope
- Repository licence ↗Checked
https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/LICENSE
Supports: Redistribution terms
- Install instructions ↗Checked
https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/README.md
Supports: Documented install path
https://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation/SKILL.md
Supports: bestFor, review
https://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/README.md
Supports: review