# OpenTelemetry Agent Skills

This repository contains reusable agent skills for OpenTelemetry.

The skills are **non-opinionated by design** — there are many valid ways to use OpenTelemetry, and prescribing conventions is out of scope.

They are designed for **token-efficient, agent-friendly retrieval**: small fetch tables, lookup indexes, and scripts that point at upstream sources of truth instead of copying docs into context. The agent finds what it missed during training; answers stay current as the project evolves.

## Installation

### skills.sh

Install all skills:

```bash npx skills add https://github.com/ollygarden/opentelemetry-agent-skills ```

Or install a single skill by pointing at its folder, e.g.:

```bash npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-go ```

### Claude Code

1. Register the repository as a plugin marketplace:

``` /plugin marketplace add ollygarden/opentelemetry-agent-skills ```

2. Install a skill:

``` /plugin install <skill-name>@opentelemetry-agent-skills ```

For example:

``` /plugin install otel-go@opentelemetry-agent-skills ```

## Repository Structure

Each skill is a self-contained folder under `skills/`, named to match its `name:` field per the [agentskills.io specification](https://agentskills.io/specification). Language-specific skills bundle task-focused references; language-agnostic skills sit alongside them.

``` skills/ otel-go/ SKILL.md # name: otel-go references/ # declarative-setup, api, instrumentation-libraries, performance, breaking-changes, compile-time-instrumentation otel-java/ SKILL.md references/ otel-js/ SKILL.md references/ otel-python/ SKILL.md references/ otel-dotnet/ SKILL.md references/ otel-browser/ SKILL.md references/ # setup-sdk, instrumentation, performance otel-collector/ SKILL.md components/ # one directory per Coll