Agent Skills
Install and route agent work across Datadog pup, monitors, logs, APM, docs, LLM observability, and browser SDK skills with a consistent command policy.
Overview
Agent Skills (Datadog) is an agent skill most often used in Operate (also Ship and Grow) that maps monitoring, logging, tracing, and LLM observability tasks to installable dd-* sub-skills and a disciplined pup command wo
Install
npx skills add https://github.com/datadog-labs/agent-skills --skill agent-skillsWhat is this skill?
- Seven core skills: dd-pup, dd-monitors, dd-logs, dd-apm, dd-docs, dd-llmo, dd-browser-sdk
- Five-step command execution policy: context first, discovery, ask user, then target command—avoid speculative failures
- npx skills add datadog-labs/agent-skills with per-skill flags and --full-depth
- Quick reference table mapping tasks to pup commands
- Version metadata 1.0.2; prerequisites point to Setup Pup auth documentation
- 7 core skills listed
- 5-step command execution policy
- metadata version 1.0.2
Adoption & trust: 851 installs on skills.sh; 127 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent guesses Datadog CLI commands and installs the wrong skill depth, causing failed auth, redundant searches, and missing monitors or trace context during outages.
Who is it for?
Builders already on Datadog who want Claude Code or Cursor agents to use pup, monitors, logs, and APM skills with documented install and auth paths.
Skip if: Projects with no Datadog account or teams that forbid agents from running observability CLIs against production.
When should I use this skill?
When an agent needs Datadog monitoring, logging, tracing, documentation, LLM observability, or browser SDK capabilities and must choose installable sub-skills.
What do I get? / Deliverables
You install the right dd-* skills, authenticate via pup setup guidance, and follow the five-step execution policy so discovery precedes destructive or ambiguous Datadog API calls.
- Correct dd-* skill install command list
- Agent-ready quick reference for scoped pup operations
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Operate monitoring is the canonical shelf because the umbrella skill centers on observability—monitors, logs, traces, RUM, and LLM telemetry—for production systems. Monitoring subphase reflects dd-monitors, dd-logs, dd-apm, dd-llmo, and browser RUM as ongoing production visibility rather than one-off coding tasks.
Where it fits
Confirm monitors and alert muting workflows via dd-monitors before go-live.
Search logs and trace slow services with dd-logs and dd-apm during an incident.
Use dd-llmo and browser SDK skills to evaluate LLM experiments and RUM after launches.
How it compares
Meta skill index and install router—not a replacement for dd-pup when executing a specific query or monitor mutation.
Common Questions / FAQ
Who is agent-skills for?
Solo developers and small teams using Datadog in production who want agents to pick the correct observability sub-skill and avoid speculative pup commands.
When should I use agent-skills?
Use it in Operate when triaging errors or tuning monitors, in Ship when validating alerts before release, and in Grow when analyzing APM or RUM trends—anytime you need the Datadog skill map and install commands.
Is agent-skills safe to install?
Child skills can query production telemetry and change monitors; review the Security Audits panel on this Prism page, lock down pup credentials, and scope agent permissions before enabling network-facing skills.
Workflow Chain
Then invoke: dd pup, dd monitors
SKILL.md
READMESKILL.md - Agent Skills
# 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 ```bash # 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](https://github.com/datadog-labs/agent-skills/tree/main?tab=readme-ov-file#setup-pup) for installation and authentication. ## Command Execution Policy Use this order for scoped commands: 1. Check context first (conversation, prior outputs, known values). 2. Run discovery commands when required values are missing. 3. Ask the user only when values remain ambiguous. 4. Run the target command after required inputs are known. 5. 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 ```bash 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. ```bash npx skills add datadog-labs/agent-skills --list --full-depth ``` --- name: dd-apm description: APM - install, onboard, instrument, enable, set up, configure, traces, services, dependencies, performance analysis. Use for any request involving Datadog APM setup, instrumentation (SSI, ddtrace, agent install), or analysis. alwaysApply: true metadata: version: "1.0.1" author: datadog-labs repository: https://github.com/datadog-labs/agent-skills tags: datadog,apm,tracing,performance,distributed-tracing,dd-apm,install,onboarding,instrumentation,ssi,agent globs: "**/ddtrace*,**/datadog*.yaml,**/*trace*" --- # Datadog APM Distributed tracing, service maps, and performance analysis. ## Routing — Read This First **For Kubernetes APM install / instrument / onboard tasks — follow this procedure exactly:** > ⚠️ **Common wrong approaches that LOOK like they work but silently fail:** > - `helm install datadog datadog/datadog` — the standard chart does NOT support SSI via DatadogAgent CR. Do NOT use it. > - Adding `ddtrace` imports or `ddtrace-run` to the app — SSI auto-instruments WITHOUT any code changes. > - `admission.datadoghq.com/enabled` annotations — this is admission controller config injection, not SSI init container injection. ### Step 0: Pre-flight checks (MANDATORY — run before installing anything) ```bash # Check for ddtrace/otel — even without imports it SILENTLY DISABLES SSI at runtime grep -rn "ddtrace\|dd-trace\|opentelemetry" requirements.txt package.json Gemfile go.mod pom.xml 2>/dev/null || echo "No tracer dependency found" ``` If ddtrace found → remove that line entirely from the dependency file, rebuild image, reload into cluster, restart pod. ### Step 1: Install the Datadog Operator (NOT `datadog