{
  "markdown": "# Observability Skills\n\nA collection of skills for AI coding agents covering observability, tracing, and OpenTelemetry workflows. Skills are packaged instructions and scripts that extend agent capabilities.\n\nSkills follow the [Agent Skills format](https://agentskills.io/home).\n\n## Installation\n\n### Using npx (requires Node.js)\n\n```bash\nnpx skills add metalbear-co/observability-skills\n```\n\n### Claude Code plugin\n\n```bash\n/plugin marketplace add metalbear-co/observability-skills\n```\n\n## Available Skills\n\n| Skill | Description |\n|-------|-------------|\n| [setup-otel-propagation](./skills/setup-otel-propagation/) | Configure OpenTelemetry context propagation (`OTEL_PROPAGATORS`) for services, especially when using mirrord. |\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected.\n\n**Examples:**\n- \"Set OTEL_PROPAGATORS for my service\"\n- \"How do I configure W3C tracecontext and B3 propagation together?\"\n- \"Make sure downstream services see the right trace context\"\n\n## Skill Structure\n\nEach skill lives in its own directory under `skills/` and contains:\n\n- `SKILL.md` — frontmatter (`name`, `description`, `metadata`) plus instructions for the agent\n- `scripts/` — helper scripts for automation (optional)\n- `references/` — supporting documentation the agent can read (optional)\n\n```\nskills/\n└── setup-otel-propagation/\n    ├── SKILL.md\n    └── references/\n```\n\n## Adding a New Skill\n\n1. **Create the directory** — `mkdir skills/<your-skill-name>`.\n2. **Write `SKILL.md`** — start with frontmatter, then the body. The `name` must match the\n   directory name; the `description` is what the agent matches on to decide when to fire, so\n   make it specific (list trigger phrases, tools, env vars, error messages).\n   ```markdown\n   ---\n   name: your-skill-name\n   description: >\n     One paragraph telling the agent exactly when to invoke this skill...\n   metadata:\n     author: MetalBear\n     version: \"0.1\"\n   ---\n\n   # Skill Title\n   ...\n   ```\n3. **Register it** in [`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json) by\n   adding `\"./skills/<your-skill-name>\"` to the `plugins[0].skills` array.\n4. **Document it** by adding a row to the *Available Skills* table above.\n5. **Bump the version** in `marketplace.json` and `.claude-plugin/plugin.json` if this is a\n   user-visible change.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n",
  "bytes": 2465,
  "sha": "15084febc72b1f39b67f6eec2e8ec1238f7b630103f144f866bc6514413b2e39",
  "repo_slug": "metalbear-co/observability-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_metalbear_co_observability_skills_observ_b868d0bc/readme"
}