agent-skills

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

1d:[