Overview
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 98k 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.
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
Installation
Add observability-and-instrumentation to your agent with:
/plugin marketplace add addyosmani/agent-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- Antigravity — declared in the repository topics
License
observability-and-instrumentation is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in addyosmani/agent-skills, an established project with 97,992 GitHub stars
- Works with Claude Code, Codex, Cursor, Antigravity
- Actively maintained — repository updated in the last 30 days
- Its repository gained 16,916 GitHub stars over the last 52 days
Author
Topics
Alternatives to observability-and-instrumentation
Similar skills from other repositories:
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.
- Which agents does observability-and-instrumentation work with?
- observability-and-instrumentation lists Claude Code, Codex, Cursor, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does observability-and-instrumentation come from?
- observability-and-instrumentation ships inside addyosmani/agent-skills, a repository that contains 26 catalogued skills in total. The repository's 97,992 GitHub stars apply to that whole collection, not to this skill on its own.
