Oodle Agent Skills
Public repository of agent skills for the Oodle observability platform. Each skill is a structured SKILL.md document that teaches AI coding assistants (Claude Code, Cursor, Gemini CLI, Codex, Windsurf, and the Oodle CLI itself) how to drive the oodle CLI correctly — with prescriptive rules, executable examples, and clear failure-handling guidance.
These skills are designed so that an AI assistant can:
- Discover and operate Oodle resources (monitors, dashboards, notifiers, traces, metrics, synthetic monitors, drop rules, log metrics, integrations) and run PromQL/log queries with a single, predictable workflow.
- Avoid common mistakes such as alert fatigue, accidental dashboard overwrites, untested notifiers, and runaway metric ingestion costs.
- Produce output that other tools and scripts can consume (
-o json) and run safely in CI (--force, --retries N).
Available Skills
| Skill | Description |
|---|
| oodle-cli | Core CLI usage — auth, output formats, time flags, file input, common patterns |
| oodle-monitors | Monitor CRUD, alerting thresholds, query scoping, runbook links |
| oodle-dashboards | Dashboard and folder management with safe-update / safe-delete patterns |
| oodle-alerting | Notifiers, notification policies, muting rules |
| oodle-metrics | Metric queries, label discovery, PromQL building |
| oodle-traces | Trace search by service, operation, duration, error |
| oodle-log-metrics | Log-based metric rules — filters and groupBy |
| oodle-synthetic | HTTP/TCP synthetic monitors with assertions |
| oodle-metrics-query | PromQL instant and range queries |
| oodle-logs | Log search and index pattern discovery |
| oodle-drop-rules | Metric drop / sample rules for ingestion cost control |
| oodle-onboarding | Integration onboarding — list integrations, fetch setup specs, execute step-by-step installation |
Install
Primary: Oodle CLI (recommended)
The Oodle CLI ships its own skills installer that places every skill in the right location for the AI agent that's currently active in your shell.
oodle skills install
Claude Code
npx skills add oodle-ai/agent-skills -a claude-code -y -g
This installs the skills globally under ~/.claude/skills/ and registers the plugin manifest from .claude-plugin/plugin.json.
Cursor
npx skills add oodle-ai/agent-skills -a cursor -y -g
This installs the skills into Cursor's rules directory and uses .cursor-plugin/plugin.json for plugin metadata.
Gemini CLI
npx skills add oodle-ai/agent-skills -a gemini-cli -y -g
The gemini-extension.json manifest at the repo root is picked up automatically.
Codex
npx skills add oodle-ai/agent-skills -a codex -y -g
Windsurf
npx skills add oodle-ai/agent-skills -a windsurf -y -g
Manual install
Clone the repo and copy the skills/ directory into your agent's skills location.
git clone https://github.com/oodle-ai/agent-skills.git
cp -r agent-skills/skills/* ~/.<agent>/skills/
Quick Reference
