observability-and-instrumentation

observability-and-instrumentation is an open-source data skill for Claude Code and compatible agents, published by addyosmani. Its author describes it as: “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 whe…”. The project has 88k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add addyosmani/agent-skills`.

What observability-and-instrumentation does

Code you can't observe is code you can't operate. Observability is the ability to answer "what is the system doing and why?" from the outside, using the telemetry the code emits. Instrumentation is not a post-launch add-on — it's written alongside the feature, the same way tests are. If a feature ships without telemetry, the first user-reported bug becomes archaeology instead of a query.

Installation

Add observability-and-instrumentation to your agent with:

/plugin marketplace add addyosmani/agent-skills

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for observability-and-instrumentation is organised into these sections:

• Overview
• When to Use
• Process
• 1. Define "working" before instrumenting
• 2. Pick the right signal for each question
• 3. Structured logging
• 4. Metrics
• 5. Distributed tracing
• 6. Alerting
• 7. Verify the telemetry itself
• Common Rationalizations
• Red Flags

When to use it

Reach for observability-and-instrumentation when you want data help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in addyosmani/agent-skills, an established project with 88,280 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does observability-and-instrumentation do?

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.

How do I install observability-and-instrumentation?

Run /plugin marketplace add addyosmani/agent-skills in your agent, then reload your skills. Review the source at https://github.com/addyosmani/agent-skills before installing.

Is observability-and-instrumentation free to use?

Yes. observability-and-instrumentation is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does observability-and-instrumentation come from?

observability-and-instrumentation ships inside addyosmani/agent-skills, a repository that contains 25 catalogued skills in total. The repository's 88,280 GitHub stars apply to that whole collection, not to this skill on its own.