observability-and-instrumentation

Mechanism

When It Triggers · How It Works · What It Produces

Breaks down how the skill works and what it produces, so you can quickly judge whether it fits your scenario and value.

Trigger

When building any feature that runs in production
When adding new services, endpoints, background jobs, or external integrations
When production incidents take too long to diagnose

Mechanism

Define "working" first: write 2-4 questions on-call will ask
Choose right signal: structured logs (what happened), metrics (how often/fast), traces (where time went)
Structured logging: JSON format, stable event names, machine-readable fields
Alerting: symptom-based, focused on user experience degradation

Outcome

Telemetry system (logs, metrics, traces, alerts) shipped alongside feature code

Use Cases

Two Typical Use Cases

Scenario 01

Operations Telemetry Integration for New Features

When developing a new feature, the agent adds telemetry synchronously, first defining 2-4 questions on-call engineers will ask, then selecting appropriate signals (logs/metrics/traces), ensuring problems are queryable without guesswork after launch.

Scenario 02

Post-Incident Telemetry Improvement

When production incidents take too long to diagnose, the agent analyzes which telemetry signals were missing, adding structured logs, key metrics, and alerting rules based on "what we wished we knew last time".

Skill Relationships

Which Skills I Use · Which Skills Use Me

Dependency relationships read as "the upper tier points to the lower tier." The current Skill sits in the middle tier — above are Skills that depend on it, below are Skills it depends on.

Tier 1 · These Skills Use Me

shipping-and-launchWorkflow

Tier 2 · Current Skill

observability-and-instrumentationWorkflow

Tier 3 · I Use These Skills

No explicit dependency on other Skills

Full Relationship Graph

Browse this skill's relationships within its skillset. Click a node to switch the side panel; use the search box to jump to any skill.

Skill File

SKILL.md

Open in GitHub ↗

SKILL.mdLoading from GitHub…

Skill Composition

Open in GitHub ↗

SKILL.md100.0%

▸skills/observability-and-instrumentation/
▸observability-and-instrumentation
- ·SKILL.md

Per the Agent Skills spec, SKILL.md is the only required file. The colored bars classify the rest into the three spec-aligned optional directories (scripts / references / assets) and an 'other' bucket. The full directory tree is below.

Related in Skillset

You May Also Need These Skills

api-and-interface-design

Guides agents to design stable, hard-to-misuse public interfaces using contract-first principles. Covers REST, GraphQL, module boundaries, component props, emphasizing Hyrum's Law, One-Version Rule, error semantics, and boundary validation. Produces consistent, maintainable, well-documented interface specifications.

Workflow

browser-testing-with-devtools

Browser testing skill that gives agents live browser runtime visibility via Chrome DevTools MCP. Supports DOM inspection, console log capture, network request analysis, performance profiling, and visual output verification. Bridges the gap between static code analysis and live browser execution.

CLI Manual

ci-cd-and-automation

CI/CD automation skill that guides agents to set up and maintain automated build and deployment pipelines. Emphasizes shifting quality gates left, integrating tests, lint, type checking, and build verification into every change. Follows the "smaller is faster is safer" principle with frequent small releases.

Workflow

code-review-and-quality

Code review and quality skill that guides agents to conduct multi-axis code reviews covering correctness, design, maintainability, security, and performance. Emphasizes change sizing (~100 lines), severity labels (Nit/Optional/FYI), and splitting strategies to ensure code quality before every merge.

Workflow

When It Triggers · How It Works · What It Produces

Trigger

Mechanism

Outcome

Two Typical Use Cases

Operations Telemetry Integration for New Features

Post-Incident Telemetry Improvement

Which Skills I Use · Which Skills Use Me

Full Relationship Graph

SKILL.md

Skill Composition

You May Also Need These Skills

api-and-interface-design

browser-testing-with-devtools

ci-cd-and-automation

code-review-and-quality

/observability-and-instrumentation

Two Typical Use Cases

Operations Telemetry Integration for New Features

Post-Incident Telemetry Improvement

SKILL.md

Skill Composition

When It Triggers · How It Works · What It Produces

Trigger

Mechanism

Outcome

You May Also Need These Skills

api-and-interface-design

browser-testing-with-devtools

ci-cd-and-automation

code-review-and-quality

Which Skills I Use · Which Skills Use Me

Full Relationship Graph