OBSERVABILITY / Addy Osmani
Observability and instrumentation
Plans feature telemetry around operational questions and verifies logs, metrics, traces and alerts in staging.
“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.
- Keeps request correlation separate from the entry point that actually initiated a shared job.
- Uses bounded metric labels, field allowlists and deliberate failure tests to check telemetry rather than assuming instrumentation works.
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 (complete frontmatter and body)
- https://github.com/addyosmani/agent-skills/blob/1401c8b8030e023baeebb31781a6653fe8e93026/LICENSE (applicable licence text)
Our findings
- Keeps request correlation separate from the entry point that actually initiated a shared job.
- Uses bounded metric labels, field allowlists and deliberate failure tests to check telemetry rather than assuming instrumentation works.
- Edits application logging/metrics/tracing and alert configuration; verification emits telemetry, sends test traffic and may trigger notification channels.
Not established by this review
- Host discovery, task execution and model quality were not tested.
- Referenced helpers, sibling plugins and external service operations were not exhaustively audited or executed.
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@1.7.1 add https://github.com/addyosmani/agent-skills/tree/1401c8b8030e023baeebb31781a6653fe8e93026/skills/observability-and-instrumentation --skill observability-and-instrumentation Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Use the exact reviewed directory/revision and select the intended host/project scope in Skills CLI.
- 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: summary, whySelected, limitations, access, review
- 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