SKILL.md
Datadog Skills
Essential Datadog skills for AI agents.
Core Skills
Skill
Description
dd-pup
Primary CLI - all pup commands, auth, PATH setup
dd-monitors
Create, manage, mute monitors and alerts
dd-logs
Search logs, pipelines, archives
dd-apm
Traces, services, performance analysis
dd-docs
Search Datadog documentation
dd-llmo
LLM Observability traces, experiments, evals
dd-browser-sdk
Browser SDK setup, RUM, Logs, Session Replay, version migration
Install
# Install core skills
npx skills add datadog-labs/agent-skills \
--skill dd-pup \
--skill dd-monitors \
--skill dd-logs \
--skill dd-apm \
--skill dd-docs \
--full-depth -y
Prerequisites
See Setup Pup for installation and authentication.
Command Execution Policy
Use this order for scoped commands:
- Check context first (conversation, prior outputs, known values).
- Run discovery commands when required values are missing.
- Ask the user only when values remain ambiguous.
- Run the target command after required inputs are known.
- Avoid speculative commands likely to fail.
Quick Reference
Task
Command
Search error logs
pup logs search --query "status:error" --from 1h
List monitors
pup monitors list
Schedule monitor downtime
pup downtime create --file downtime.json
Find slow traces
pup traces search --query "service:api @duration:>500ms" --from 1h
Query metrics
pup metrics query --query "avg:system.cpu.user{*}"
Check auth
pup auth status
Refresh token
pup auth refresh
Auth
pup auth login # OAuth2 (recommended)
pup auth status # Check token
pup auth refresh # Refresh expired token
⚠️ Token Expiry: OAuth tokens expire (~1 hour). Run pup auth refresh if commands fail with 401/403.
More Skills
Additional skills available shortly.
npx skills add datadog-labs/agent-skills --list --full-depth