otel-telemetry-emissions — Claude Code skill: how to install
Version-pinned registry of telemetry emitted by OpenTelemetry components and SDKs. Inspect spans, metrics, and logs before updating collector pipelines.
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-codeWhat otel-telemetry-emissions does
The skill equips coding agents with a structured inventory of OpenTelemetry signals across specific releases. It catalogs components from collector repositories and instrumentation packages, storing each version in a separate markdown file like opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md. The agent starts at index.md to locate exact versions or pick the closest prior release.
Data files outline trace spans, metric instruments with units, and log events alongside required attributes. The scope_name field records the instrumentation scope so runtime records match their components. In addition, conditional telemetry gated behind feature flags is documented in notes tables.
Because entries stem from automated LLM analysis of upstream repositories, double-checking against the original source code remains necessary for sensitive production setups.
What it helps with
- Inspect spans and metrics for an OpenTelemetry receiver at an exact version
- Audit attribute changes before upgrading collector components or SDKs
- Identify the correct instrumentation scope name for incoming logs
- Check which metrics require opt-in flags or experimental semantic conventions
Example prompts for the agent
- Show all metrics and spans emitted by kafkareceiver in version v0.158.0
- Check if the telemetry changed between the current and target SDK versions
- Look up the instrumentation scope name for this collector component
How to install otel-telemetry-emissions
1Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code2Manually: put the files in place
~/.claude/skills/otel-telemetry-emissions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/otel-telemetry-emissions/
1Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a codex2Manually: put the files in place
.agents/skills/otel-telemetry-emissions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a cursor2Manually: put the files in place
.cursor/skills/otel-telemetry-emissions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ollygarden/opentelemetry-agent-skills otel-telemetry-emissions2Manually: put the files in place
.github/skills/otel-telemetry-emissions/SKILL.md1Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a gemini-cli2Platform CLI
gemini skills install https://github.com/ollygarden/opentelemetry-agent-skills --path skills/otel-telemetry-emissionsManually: put the files in place
.devin/skills/otel-telemetry-emissions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about otel-telemetry-emissions
How to install otel-telemetry-emissions in Claude Code?
Run npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code in your terminal.
What does otel-telemetry-emissions do?
It provides a versioned catalog of traces, metrics, and logs emitted by OpenTelemetry components. Agents query it to verify telemetry changes before upgrades.
How accurate is the inventory data?
Tables are generated through LLM evaluation of upstream repositories. You should verify details against upstream source files or documentation before making architectural decisions.
Source text
SKILL.md · Apache-2.0
--- name: otel-telemetry-emissions description: Version-pinned inventory of the telemetry (spans, metrics, logs, attributes) emitted by OpenTelemetry collector components and SDK instrumentation packages. Use when working with a covered component — what it emits at a given version, or how emission changed across versions — and when upgrading a component or SDK version, to see the telemetry after the change. --- # Telemetry Emissions A registry of what telemetry OpenTelemetry components actually emit, pinned to upstream versions. > **Note:** The telemetry emissions in these files were detected by LLM > analysis of the upstream source and may contain errors. Verify against the > component's source or docs before relying on a row for critical decisions. ## Layout ``` <repo basename>/<path in repo>/v<version>.md ``` Example: `opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md` One file per scanned version. The files in a component directory are its telemetry history; `index.md` lists every file — start there to see what is covered. ## Looking up a component at a version 1. Find the component's directory (or its row in `index.md`). 2. Pick the file matching the target version exactly. 3. If there is no exact match, use the file with the highest version below the target and say the exact version is unverified. 4. If the component or version is not covered at all, say so — do not infer telemetry from semantic conventions. ## What a data file contains Frontmatter (`repo`, `path`, `version`, `scope_name`, `commit_sha`, `last_verified`), then per-signal tables: - **Traces** — span name, kind, attributes, notes - **Metrics** — metric name, instrument type, unit, attributes, notes - **Logs** — log/event name, attributes, notes `scope_name` is the component's instrumentation scope — the anchor for matching runtime telemetry back to the component. When helper or pipeline telemetry uses another scope, its rows name that scope in `Notes`. `last_verified: null` means the historical verification date could not be substantiated; recheck the pinned source before presenting its rows as verified. Absent signals are omitted entirely. `Notes` marks conditional emission (feature gates, opt-in config, experimental semconv). `Sources` lists the upstream files the data came from.
© ollygarden · Apache-2.0 · ollygarden/opentelemetry-agent-skills