1---2name: datadog-ninja3description: >-4 Master orchestrator for 57 official Datadog agent skills from DataDog/pup and datadog-labs/agent-skills.5 Use when working with ANY Datadog observability task: APM and distributed tracing, log search and pipelines,6 monitors and alerting, live production debugging, audit trail investigations, browser SDK instrumentation,7 Agent Observability (LLM Ops), cloud integrations (AWS/Azure/GCP/OCI), CI/CD visibility, flaky tests,8 Single-Step Instrumentation (SSI), Datadog Apps, or security posture management.9 Routes to the optimal specialized skill based on context.10 Triggers: Datadog, DataDog, dd, pup CLI, APM, distributed tracing, traces, spans, service map,11 flame graph, datadog logs, log pipelines, log archives, log indexes, monitors, alerting,12 mute, downtime, live debugger, dynamic instrumentation, log probes, symbol database, symdb,13 CI Visibility, flaky test, test optimization, unblock PR, ddtrace, DD_API_KEY, DD_SITE,14 audit trail, who changed, compliance, SOC 2, PCI, browser SDK, RUM, session replay,15 Agent Observability, LLM Obs, experiments, evaluators, traces RCA, SSI, Single-Step Instrumentation,16 Kubernetes agent, Linux agent, AWS integration, Azure integration, GCP integration, OCI integration,17 Datadog Apps, App Builder, CSM, cloud security.18metadata:19 source: https://skillmd.com/skills/fabricioctelles/datadog-ninja20---2122# Datadog Ninja2324**Jump Skill** — Master orchestrator that routes Datadog observability tasks to 57 specialized skills from official Datadog repositories.2526## Purpose2728This skill acts as an intelligent router to the comprehensive Datadog skills library. Instead of manually searching for the right skill, describe your observability task and this skill will:29301. Identify the most relevant specialized skill(s)312. Load the full skill instructions on demand323. Execute the task with expert-level Datadog knowledge3334## Prerequisites3536Most skills drive the **`pup` CLI** (the official Datadog CLI). Before executing a task:37381. Route to `dd-pup` if `pup` is not installed or not authenticated392. `pup` uses OAuth2 with token refresh — no long-lived key in the shell for interactive use403. Some skills use `DD_API_KEY` / `DD_APP_KEY` directly for API access414. Datadog site matters (`datadoghq.com`, `datadoghq.eu`, `us3`, `us5`, `ap1`) — confirm `DD_SITE` before API calls4243> **Read operations** (searching logs, inspecting traces, listing monitors) are safe to run directly.44> **Write operations** (creating monitors, placing probes, deleting pipelines) change production state — confirm with the user first.4546---4748## Skill Catalog4950### CLI & Foundation (from DataDog/pup)5152| Skill | Path | Use When |53|-------|------|----------|54| `dd-pup` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-pup/` | Install/authenticate the `pup` CLI, OAuth2 setup, token refresh, org and site selection |55| `dd-docs` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-docs/` | Look up Datadog documentation via `docs.datadoghq.com/llms.txt` |56| `dd-code-generation` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-code-generation/` | Generate application code using Datadog API clients (TypeScript, Python, Java, Go, Rust) |57| `dd-file-issue` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-file-issue/` | File a bug or feature request against the `pup` CLI |5859### APM & Tracing6061| Skill | Path | Use When |62|-------|------|----------|63| `dd-apm` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-apm/` | Traces, services, dependencies, performance analysis (pup) |64| `dd-apm` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/` | Extended APM with SSI onboarding workflows |65| `service-remapping` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/service-remapping/` | Remap service names in APM |6667#### Single-Step Instrumentation (SSI) — Kubernetes6869| Skill | Path | Use When |70|-------|------|----------|71| `k8s-agent-install` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/k8s-ssi/agent-install/` | Install Datadog Agent on Kubernetes |72| `k8s-enable-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/k8s-ssi/enable-ssi/` | Enable SSI on K8s cluster |73| `k8s-verify-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/k8s-ssi/verify-ssi/` | Verify SSI is working on K8s |74| `k8s-troubleshoot-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/k8s-ssi/troubleshoot-ssi/` | Troubleshoot SSI issues on K8s |75| `k8s-onboarding-summary` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/k8s-ssi/onboarding-summary/` | SSI onboarding summary for K8s |7677#### Single-Step Instrumentation (SSI) — Linux7879| Skill | Path | Use When |80|-------|------|----------|81| `linux-agent-install` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/linux-ssi/agent-install/` | Install Datadog Agent on Linux hosts |82| `linux-enable-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/linux-ssi/enable-ssi/` | Enable SSI on Linux |83| `linux-verify-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/linux-ssi/verify-ssi/` | Verify SSI is working on Linux |84| `linux-troubleshoot-ssi` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/linux-ssi/troubleshoot-ssi/` | Troubleshoot SSI issues on Linux |85| `linux-onboarding-summary` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apm/linux-ssi/onboarding-summary/` | SSI onboarding summary for Linux |8687### Logs8889| Skill | Path | Use When |90|-------|------|----------|91| `dd-logs` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-logs/` | Log search, pipelines, archives, indexes, cost control (pup) |92| `dd-logs` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-logs/` | Extended log management workflows |9394### Monitors & Alerting9596| Skill | Path | Use When |97|-------|------|----------|98| `dd-monitors` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-monitors/` | Create, update, mute monitors; alerting best practices (pup) |99| `dd-monitors` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-monitors/` | Extended monitor management |100101### Live Debugging (from DataDog/pup)102103| Skill | Path | Use When |104|-------|------|----------|105| `dd-symdb` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-symdb/` | Search a service's symbols to find probe-able methods |106| `dd-debugger` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-debugger/` | Capture runtime values in production with log probes — no redeploy |107108> `dd-symdb` almost always precedes `dd-debugger`: find the method, then probe it.109110### CI Visibility & Test Optimization111112| Skill | Path | Use When |113|-------|------|----------|114| `dd-unblock-pr` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-unblock-pr/` | PR CI failing — classify as flaky/infra/regression (pup) |115| `dd-triage-flaky-test` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/pup/skills/dd-triage-flaky-test/` | Deep-dive on a specific flaky test (pup) |116| `unblock-pr` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-software-delivery/unblock-pr/` | Extended PR unblock with MCP support |117| `triage-flaky-test` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-software-delivery/triage-flaky-test/` | Extended flaky test triage with MCP support |118119### Audit Trail120121| Skill | Path | Use When |122|-------|------|----------|123| `dd-audit` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/` | Audit Trail investigations overview |124| `security-investigation` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/security-investigation/` | Who changed what? User activity, deletions, permission changes |125| `key-compromise` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/key-compromise/` | Investigate potentially compromised API keys |126| `cost-spike-investigation` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/cost-spike-investigation/` | Why did my bill go up? Usage spike root cause |127| `compliance-report` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/compliance-report/` | Generate SOC 2 / PCI DSS evidence from audit data |128| `ai-activity-audit` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-audit/ai-activity-audit/` | Audit AI assistant / MCP tool activity |129130### Browser SDK & RUM131132| Skill | Path | Use When |133|-------|------|----------|134| `dd-browser-sdk` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-browser-sdk/` | Browser SDK overview — RUM, Logs, Session Replay, profiling |135| `upgrade-v5` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-browser-sdk/upgrade-v5/` | Upgrade Browser SDK from v4 to v5 |136| `upgrade-v6` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-browser-sdk/upgrade-v6/` | Upgrade Browser SDK from v5 to v6 |137| `upgrade-v7` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-browser-sdk/upgrade-v7/` | Upgrade Browser SDK from v6 to v7 |138| `dd-instrument-rum` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-instrument-rum/` | Instrument browser apps with RUM (React, Next.js, Angular, Vue, Svelte) |139140### Agent Observability (LLM Ops)141142| Skill | Path | Use When |143|-------|------|----------|144| `experiment-analyzer` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-experiment-analyzer/` | Analyze and compare offline LLM experiments |145| `experiment-bootstrap` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-experiment-bootstrap/` | Bootstrap reproducible LLM experiments (Python/Node SDK) |146| `trace-rca` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-trace-rca/` | Root-cause production failures using eval judge signal |147| `eval-bootstrap` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-eval-bootstrap/` | Generate evaluator code from production traces |148| `eval-pipeline` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-eval-pipeline/` | End-to-end pipeline: classify → RCA → bootstrap → experiment → analyze |149| `session-classify` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-session-classify/` | Classify if user intent was satisfied in a session |150| `auto-experiment` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-auto-experiment/` | Local hill-climb: baseline-eval a prompt, iterate improvements |151| `replay-trace` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/agent-observability/agent-observability-replay-trace/` | Re-run a trace against local code, diff old vs new output |152153### Cloud Integrations154155| Skill | Path | Use When |156|-------|------|----------|157| `dd-aws-integration` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-aws-integration/` | Set up AWS integration with Datadog |158| `dd-azure-integration` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-azure-integration/` | Set up Azure integration with Datadog |159| `dd-gcp-integration` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-gcp-integration/` | Set up GCP integration with Datadog |160| `dd-oci-integration` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-oci-integration/` | Set up Oracle Cloud (OCI) integration with Datadog |161162### Security & Compliance163164| Skill | Path | Use When |165|-------|------|----------|166| `csm-ownership-agent` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-security/csm/ownership-agent/` | Cloud Security Management ownership setup |167168### Datadog Apps169170| Skill | Path | Use When |171|-------|------|----------|172| `datadog-app` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-apps/datadog-app/` | Build Datadog Apps — scaffold, run locally, upload, publish, DDSQL |173174### Account & Setup175176| Skill | Path | Use When |177|-------|------|----------|178| `dd-account-setup` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-account-setup/` | Initial Datadog account setup and configuration |179| `dd-product-recommender` | `{{JUMP_SKILLS_DIR}}/repos/datadog-ninja/agent-skills/dd-product-recommender/` | Recommend Datadog products for a codebase/goal |180181---182183## Routing Logic184185When a task arrives:186187### CLI & Auth1881. **`pup` not installed or auth failing?** → `dd-pup` first, then the real skill1892. **Datadog documentation question?** → `dd-docs`1903. **Need to generate API client code?** → `dd-code-generation`191192### Observability Core1934. **Slow service, latency, traces, spans?** → `dd-apm`1945. **Searching logs, pipelines, cost/retention?** → `dd-logs`1956. **Creating/muting alerts?** → `dd-monitors`1967. **Runtime debugging in production?** → `dd-symdb` then `dd-debugger`197198### CI/CD1998. **PR CI red, unclear why?** → `dd-unblock-pr` or `unblock-pr`2009. **One known flaky test?** → `dd-triage-flaky-test` or `triage-flaky-test`201202### Audit & Compliance20310. **Who changed what?** → `security-investigation`20411. **API key compromised?** → `key-compromise`20512. **Bill went up unexpectedly?** → `cost-spike-investigation`20613. **Need SOC 2 / PCI evidence?** → `compliance-report`20714. **What did the AI assistant do?** → `ai-activity-audit`208209### Browser & Frontend21015. **Instrument browser app with RUM?** → `dd-instrument-rum`21116. **Upgrade Browser SDK?** → `upgrade-v5`, `upgrade-v6`, or `upgrade-v7`212213### LLM Ops / Agent Observability21417. **Analyze LLM experiments?** → `experiment-analyzer`21518. **Bootstrap LLM experiment?** → `experiment-bootstrap`21619. **Root-cause LLM failures?** → `trace-rca`21720. **Generate evaluators from traces?** → `eval-bootstrap`21821. **Full eval pipeline?** → `eval-pipeline`219220### Agent Installation22122. **Install agent on Kubernetes?** → `k8s-agent-install` → `k8s-enable-ssi`22223. **Install agent on Linux?** → `linux-agent-install` → `linux-enable-ssi`22324. **Verify/troubleshoot SSI?** → `*-verify-ssi` or `*-troubleshoot-ssi`224225### Cloud Integrations22625. **Connect AWS to Datadog?** → `dd-aws-integration`22726. **Connect Azure to Datadog?** → `dd-azure-integration`22827. **Connect GCP to Datadog?** → `dd-gcp-integration`22928. **Connect OCI to Datadog?** → `dd-oci-integration`230231### Apps & Other23229. **Build a Datadog App?** → `datadog-app`23330. **Cloud security posture?** → `csm-ownership-agent`23431. **Which Datadog products do I need?** → `dd-product-recommender`23532. **Initial account setup?** → `dd-account-setup`236237---238239## Execution Pattern240241```2421. Announce: "Routing to [skill-name]..."2432. Verify: pup installed + authenticated (route to dd-pup if not)2443. Load: Read the SKILL.md from the path in the catalog2454. Execute: Follow the skill's instructions2465. Confirm: For any write operation, confirm with the user before running it2476. Cite: Reference the skill in the response248```249250---251252## Quick Reference253254| Task | Route To |255|------|----------|256| Install / authenticate Datadog CLI | `dd-pup` |257| Why is this endpoint slow? | `dd-apm` |258| Search error logs for a service | `dd-logs` |259| Create an alert | `dd-monitors` |260| What arguments does this function get in prod? | `dd-symdb` → `dd-debugger` |261| My PR's CI is red | `dd-unblock-pr` |262| Is this test flaky? | `dd-triage-flaky-test` |263| Who deleted monitors yesterday? | `security-investigation` |264| Was this API key compromised? | `key-compromise` |265| Why did my bill spike? | `cost-spike-investigation` |266| Generate SOC 2 evidence | `compliance-report` |267| Upgrade Browser SDK to v7 | `upgrade-v7` |268| Instrument React app with RUM | `dd-instrument-rum` |269| Analyze my LLM experiment | `experiment-analyzer` |270| Why is my LLM app failing? | `trace-rca` |271| Install agent on Kubernetes | `k8s-agent-install` |272| Connect AWS account | `dd-aws-integration` |273| Build a Datadog App | `datadog-app` |274275---276277## Investigation Decision Tree278279```280Something is wrong in production281282Where does the symptom show up?283├── Requests slow / erroring284│ ├── Which service? → dd-apm (service map, trace search)285│ ├── Which endpoint / span? → dd-apm (trace detail)286│ └── What were the actual runtime values? → dd-symdb → dd-debugger287├── Errors in the logs288│ ├── Find them → dd-logs (search, facets)289│ └── Logs missing or malformed → dd-logs (pipelines, indexes)290├── Alert fired (or should have)291│ └── dd-monitors (create, tune, mute)292├── Need to audit who did what293│ ├── Configuration changes → security-investigation294│ ├── API key activity → key-compromise295│ └── Cost spike → cost-spike-investigation296├── LLM / AI agent issues297│ ├── Experiment results → experiment-analyzer298│ ├── Production failures → trace-rca299│ └── Need evaluators → eval-bootstrap300└── Need the API surface for something else301 └── dd-docs → dd-code-generation302303CI is broken (not production)304├── Whole PR pipeline red → dd-unblock-pr305└── One test flapping → dd-triage-flaky-test306307Setting up Datadog308├── First time? → dd-account-setup309├── Which products? → dd-product-recommender310├── Agent on K8s? → k8s-agent-install → k8s-enable-ssi311├── Agent on Linux? → linux-agent-install → linux-enable-ssi312├── Connect AWS/Azure/GCP/OCI? → dd-*-integration313└── Browser instrumentation? → dd-instrument-rum314```315316---317318## Common `pup` Commands319320```bash321# Authentication322pup auth login # OAuth2 login323pup auth status # Verify authentication and org324325# Logs326pup logs search 'service:api status:error' --from now-1h327328# APM329pup apm services list330331# Monitors332pup monitors list --tags team:platform333pup monitors mute <monitor_id> --end <ts>334335# Audit336pup audit-logs search --query "@action:deleted" --from 24h337```338339> Exact flags vary by `pup` version — route to `dd-pup` and confirm against `pup --help`.340341---342343## Repositories344345| Repository | Skills | License | Description |346|------------|--------|---------|-------------|347| [DataDog/pup](https://github.com/DataDog/pup) | 11 | Apache-2.0 | Official Datadog CLI and bundled agent skills |348| [datadog-labs/agent-skills](https://github.com/datadog-labs/agent-skills) | 46 | MIT | Extended skills: Agent Observability, Audit, Browser SDK, SSI, Cloud Integrations |349350## Statistics351352- **Total Skills:** 57353- **Repositories:** 2 (official Datadog)354- **Licenses:** Apache-2.0, MIT355356---357358*Jump Skill maintained at github.com/fabricioctelles/jump-skills*