Official agent skill

Dd Symdb

Symbol Database - search service symbols, find probe-able methods.

OfficialApache-2.0Auto-check passed

Install Dd Symdb

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dd-symdb .claude/skills/dd-symdb && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .claude/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/DataDog/pup/tree/main/skills/dd-symdb

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/dd-symdb .agents/skills/dd-symdb && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .agents/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/dd-symdb .cursor/skills/dd-symdb && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .cursor/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/DataDog/pup.git --path skills/dd-symdb

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/dd-symdb .gemini/skills/dd-symdb && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .gemini/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/dd-symdb .github/skills/dd-symdb && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .github/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DataDog/pup --skill dd-symdb -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-symdb --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/dd-symdb .opencode/skills/dd-symdb && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "dd-symdb" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-symdb into .opencode/skills/dd-symdb/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-symdb", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: dd-symdb
GitHub stars: 1k
Token cost: ~782 tokens
SKILL.md length: 169 words
Files: 1
Skills in repo: 12
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Symbol Database - search service symbols, find probe-able methods.

SKILL.md covers Prerequisites, Authentication, Usage and Combining with Debugger, plus 3 more sections
Calls brew; needs DD_API_KEY and DD_APP_KEY

What it does

Dd Symdb is an agent skill from DataDog/pup, published by the product's own GitHub organization. Symbol Database - search service symbols, find probe-able methods.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Datadog. The repository describes itself as: Give your AI agent a Pup — a CLI companion with 200+ commands across 33+ Datadog products. The licence is Apache-2.0.

Example prompts

“/dd-symdb”

Requirements

A credential in DD_API_KEY
A credential in DD_APP_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 6a3c662. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- brew
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- docs.datadoghq.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- DD_API_KEY
- DD_APP_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dd Symdb loads about 782 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 169 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~19
When it runs · the whole SKILL.md, loaded when a task matches: ~782

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DataDog/pup at commit 6a3c662, republished under its Apache-2.0 licence (© DataDog). 169 words, ~782 tokens.

Download SKILL.mdSave it as .claude/skills/dd-symdb/SKILL.md (or your agent's skills folder).

name: dd-symdb
description: Symbol Database - search service symbols, find probe-able methods.
metadata.version: 1.0.0
metadata.author: datadog-labs
metadata.repository: https://github.com/datadog-labs/agent-skills
metadata.tags: datadog,symdb,symbol-database,live-debugger
metadata.alwaysApply: false

Datadog Symbol Database

Search for classes and methods in instrumented services. Find probe-able method locations for use with the Live Debugger.

Prerequisites

pup must be installed:

bash

brew tap datadog-labs/pack && brew install pup

Authentication

Authenticate via OAuth2 (recommended) or API keys:

bash

# OAuth2 (recommended)
pup auth login

# Or use API keys
export DD_API_KEY="key" DD_APP_KEY="key" DD_SITE="datadoghq.com"

Usage

Names View

One scope name per line.

bash

pup symdb search --service my-service --query "Controller" --view names

Probe Locations View

TYPE:METHOD(arg1, arg2, ...) signatures suitable for --probe-location in pup debugger probes create. Falls back to TYPE:METHOD when no argument info is available.

bash

pup symdb search --service my-service --query "VetController" --view probe-locations

Full View

Raw JSON response from the API.

bash

pup symdb search --service my-service --query "VetController" --view full

Filter by Version

bash

pup symdb search --service my-service --query "handler" --version "v1.2.3" --view names

Combining with Debugger

Find methods then place probes:

bash

# 1. Find probe-able methods
pup symdb search --service my-service --query "MyController" --view probe-locations

# 2. Place a probe on a discovered method (language auto-detected from symdb)
pup debugger probes create \
  --service my-service \
  --env production \
  --probe-location "com.example.MyController:handleRequest" \
  --template "handleRequest called with id={id}"

# Or use the full signature when multiple overloads exist
pup debugger probes create \
  --service my-service \
  --env production \
  --probe-location "com.example.MyController:handleRequest(int, java.lang.String)" \
  --template "handleRequest called with id={id}"

# 3. Stream events
pup debugger probes watch <PROBE_ID> --timeout 60 --limit 10

Options

Flag	Description	Default
`--service`	Service name (required)	—
`--query`	Search query, matches scope names	None (lists all)
`--version`	Service version filter	None
`--view`	Output view: `full`, `names`, `probe-locations`	`full`

Failure Handling

Problem	Fix
No results	Verify the service is instrumented and reporting to Datadog
Auth error	Run `pup auth login` or set `DD_API_KEY` + `DD_APP_KEY` + `DD_SITE`
Wrong service name	Check exact service name in Datadog APM service catalog
Stale symbols	Filter with `--version` to target the currently deployed version

References

Files

Just SKILL.md in skills/dd-symdb of DataDog/pup.

Open the folder on GitHubat commit 6a3c662

Compare with similar skills

Dd Symdb next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dd Symdb compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Dd Symdb this skillDataDog/pup	1k	—	~782	Automated safety check: Pass	Apache-2.0	yesterday
Code Design Rationale Investigatorcursor/plugins	10k	9 repos	~2.6k	Automated safety check: Pass	None	today
Triage CI FailureDataDog/datadog-agent	3.8k	—	~2.3k	Automated safety check: Pass	Apache-2.0	today
Follow PRDataDog/datadog-agent	3.8k	—	~3.2k	Automated safety check: Pass	Apache-2.0	today
Apm IntegrationsDataDog/dd-trace-js	836	—	~3k	Automated safety check: Pass	Custom licence	today
Bump LibdatadogDataDog/dd-trace-dotnet	573	—	~1.7k	Automated safety check: Pass	Apache-2.0	today

Similar skills

Code Design Rationale Investigator
cursor/plugins
Official
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
10k GitHub starsUsed in 9 repos~2.6k tokens
DevelopmentAuto-check passed
Triage CI Failure
DataDog/datadog-agent
Official
Classify a failed CI as either caused by an active incident, flakiness, or a true code regression.
3.8k GitHub stars~2.3k tokensUpdated today
Testing & QAAuto-check passed
Follow PR
DataDog/datadog-agent
Official
Monitor the current PR's GitLab pipeline to completion, then report success, auto-fix, or investigate a failure.
3.8k GitHub stars~3.2k tokensUpdated today
DevOps & CloudAuto-check passed
Apm Integrations
DataDog/dd-trace-js
Official
A skill your agent uses when adding, debugging, fixing, or modifying instrumentation and plugins for third-party libraries in dd-trace-js.
836 GitHub stars~3k tokensUpdated today
DevOps & CloudAuto-check passed
Bump Libdatadog
DataDog/dd-trace-dotnet
Official
Update/bump the libdatadog native library version in dd-trace-dotnet.
573 GitHub stars~1.7k tokensUpdated today
DevelopmentAuto-check passed
Datadog Data Source Generator
DataDog/terraform-provider-datadog
Official
Generates a Datadog Terraform provider data source from an OpenAPI operation with tfgen and opens a review-ready GitHub PR with a risk scan and testing guide.
468 GitHub stars~2.7k tokensUpdated today
DevOps & CloudAuto-check passed

Questions about Dd Symdb

What does Dd Symdb do?

Symbol Database - search service symbols, find probe-able methods. Dd Symdb is an agent skill from DataDog/pup, published by the product's own GitHub organization. Symbol Database - search service symbols, find probe-able methods.

How do I install Dd Symdb in Claude Code?

Run `npx skills add DataDog/pup --skill dd-symdb -a claude-code`. Or copy the skill folder (skills/dd-symdb in DataDog/pup) into .claude/skills/dd-symdb in your project. Claude Code loads it when a task matches its description.

How do I install Dd Symdb in Codex?

Run `npx skills add DataDog/pup --skill dd-symdb -a codex`. Or copy the skill folder (skills/dd-symdb in DataDog/pup) into .agents/skills/dd-symdb in your project. Codex loads it when a task matches its description.

Can I use Dd Symdb in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DataDog/pup --skill dd-symdb -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dd-symdb, .gemini/skills/dd-symdb, .github/skills/dd-symdb and .opencode/skills/dd-symdb in your project.

What does Dd Symdb need to run?

Going by SKILL.md and its folder, Dd Symdb needs the command-line tools its instructions call (brew) and credentials named DD_API_KEY and DD_APP_KEY. Our summary lists: A credential in DD_API_KEY; A credential in DD_APP_KEY.

Does Dd Symdb access the network?

SKILL.md names 1 domain. As links in the text: docs.datadoghq.com. This is read from the text; nothing was executed.

Is Dd Symdb safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dd Symdb use?

Dd Symdb is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dd Symdb use?

About 782 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dd Symdb?

Skills that share tags, products or a category with Dd Symdb: Code Design Rationale Investigator (cursor/plugins, 10k stars), Triage CI Failure (DataDog/datadog-agent, 3.8k stars), Follow PR (DataDog/datadog-agent, 3.8k stars) and Apm Integrations (DataDog/dd-trace-js, 836 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dd Symdb?

DataDog (a GitHub organization, an official publisher) maintains it in DataDog/pup, which has 1,027 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: DataDog/pup on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Dd Symdb

Facts

At a glance

What it does

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Datadog Symbol Database

Prerequisites

Authentication

Usage

Names View

Probe Locations View

Full View

Filter by Version

Combining with Debugger

Options

Failure Handling

References

Files

Compare with similar skills

Similar skills

More from DataDog/pup

Related

Questions about Dd Symdb