o11y-agent-skills/plugins/signoz/skills/signoz-docs

signoz-docs

Agent skill for answering SigNoz questions with official documentation from signoz.io/docs.

This skill ships inside the official signoz Claude plugin and the shared skills.sh package.

How it works

1. Docs fetch — SigNoz docs support Accept: text/markdown, so the agent can fetch clean markdown instead of scraping HTML.
2. Domain heuristics — Decision trees route the user to the right guide before fetching docs, which avoids jumping to a random page without understanding the setup.

Structure

plugins/signoz/skills/signoz-docs/
├── SKILL.md              # Entry point — goal, docs-fetch method, workflow, heuristic routing table
├── README.md
└── heuristics/
    └── sending-logs.md   # Log collection method decision tree

Adding a heuristic

1. Create a new file in heuristics/ (e.g., sending-traces.md)
2. Follow the pattern: questions → decision table → gotchas → reference link
3. Add a row to the routing table in SKILL.md:

| Sending Traces | traces, instrumentation, APM, distributed tracing | [sending-traces.md](./heuristics/sending-traces.md) |

Planned heuristics

• Sending Traces — language selection, auto vs manual instrumentation
• Sending Metrics — application metrics vs infrastructure vs Prometheus
• Troubleshooting — data not showing up, collector issues, common errors