Agent skill

Onboarding Summary

by datadog-labs in datadog-labs/agent-skills

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI.

MITAuto-check: notesDevOps & Cloud

Install Onboarding Summary

skills CLI
$ npx skills add datadog-labs/agent-skills --skill onboarding-summary -a claude-code

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

GitHub CLI
$ gh skill install datadog-labs/agent-skills onboarding-summary --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-labs/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/dd-apm/linux-ssi/onboarding-summary .claude/skills/onboarding-summary && 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/

Facts

Skill name
onboarding-summary
GitHub stars
177
Token cost
~1.2k tokens
SKILL.md length
351 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI.

  • Tasks that involve Monitoring and alerting
  • SKILL.md covers Triggers, Context to resolve before acting, Prerequisites and Collect live confirmation data, plus 2 more sections
  • Calls ssh; needs SSH_KEY

What it does

Onboarding Summary is an agent skill from datadog-labs/agent-skills. Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI. Only use after agent-install and enable-ssi have both completed.

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

It sits in DevOps & Cloud, covering Monitoring and alerting. It works with Linux and Datadog. The repository describes itself as: Public repository for Datadog Agent Skills. The licence is MIT.

When your agent uses it

  • Tasks that involve Monitoring and alerting

Example prompts

  • “/onboarding-summary”

Requirements

  • A credential in SSH_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit d2411cc. 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:

    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SSH_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Onboarding Summary loads about 1.2k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 351 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:30
    E` | Hostname as Datadog sees it — from `sudo datadog-agent status` |
  • NoteRuns commands with sudoSKILL.md:70
    sudo datadog-agent status 2>&1 | grep -E "Agent \(v|Status:|API Keys status"

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-labs/agent-skills at commit d2411cc, republished under its MIT licence (© datadog-labs). 351 words, ~1,249 tokens.

Download SKILL.mdSave it as .claude/skills/onboarding-summary/SKILL.md (or your agent's skills folder).
name
onboarding-summary
description
Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI. Only use after agent-install and enable-ssi have both completed.
metadata.version
1.0.0
metadata.author
datadog-labs
metadata.repository
https://github.com/datadog-labs/agent-skills
metadata.tags
datadog,apm,linux,ssi,summary,verification
metadata.alwaysApply
false

APM Onboarding Summary — Linux Host

Triggers

Invoke this skill when:

  • All steps in verify-ssi have passed
  • All checks in troubleshoot-ssi have been resolved
  • The user asks "is everything working?", "show me the status", or "confirm APM is set up"

Do NOT invoke this skill if any verification or troubleshooting check is still failing — resolve those first.


Context to resolve before acting

VariableHow to resolve
HOSTNAMEhostname -f on the target host
DD_HOSTNAMEHostname as Datadog sees it — from sudo datadog-agent status
SERVICE_NAMEDD_SERVICE value from /proc/<PID>/environ or the systemd unit
ENVDD_ENV value from /proc/<PID>/environ or the systemd unit
DD_SITEgrep "^site:" /etc/datadog-agent/datadog.yaml
SSH_KEYPath to SSH private key
SSH_USERSSH username
SSH_HOSTHostname or IP of the target host

Prerequisites

Claude runs
bash
pup auth status --site <DD_SITE>

If valid token — proceed.

ERROR: Not authenticated:

Claude runs
bash
pup auth login --site <DD_SITE>

This opens a browser tab for OAuth. Complete the login there — Claude will continue once the command exits.


Collect live confirmation data

Run all of the following. Each populates a row in the final report.

Claude runs
bash
# Agent version and status
sudo datadog-agent status 2>&1 | grep -E "Agent \(v|Status:|API Keys status"

# Inject library armed in ld.so.preload
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> "cat /etc/ld.so.preload"

# Process confirmed injected — launcher + language library in /proc/<PID>/maps
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "pgrep -a -f '<SERVICE_NAME>' | head -3"

Use the PID from above:

bash
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo cat /proc/<PID>/maps | grep -E 'launcher|apm-library|datadog'"

# UST vars in process environment
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo cat /proc/<PID>/environ | tr '\0' '\n' | grep -E 'DD_SERVICE|DD_ENV|DD_VERSION'"

# Agent APM receiver — trace counts
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo datadog-agent status 2>&1 | grep -A 10 'Receiver (previous minute)'"

# Service visible and traced in APM backend
DD_SITE=<DD_SITE> pup apm services list --env <ENV> --from 1h

# Traces arriving in the last hour
DD_SITE=<DD_SITE> pup traces search --query "service:<SERVICE_NAME>" --from 1h --limit 5

Only if DSM was enabled via enable-dsm:

bash
# DSM pipeline data for the service
DD_SITE=<DD_SITE> pup metrics query \
  --query "avg:data_streams.latency{service:<SERVICE_NAME>,env:<ENV>} by {pathway_type}" \
  --from 15m --to now

Show full SKILL.md (169 more words)Show less

Present the report

Fill in every value from live command output. Do not leave any placeholder unfilled. If a value cannot be confirmed, mark that row as failed and link to troubleshoot-ssi.


APM onboarding complete

CheckDetailStatus
Datadog Agentv<VERSION> running on <HOSTNAME>, API key validOK
SSI armed/etc/ld.so.preload contains launcher pathOK
Process injectedlauncher + language library in /proc/<PID>/maps for <SERVICE_NAME>OK
Unified Service TagsDD_SERVICE=<SERVICE_NAME> DD_ENV=<ENV> DD_VERSION=<VERSION>OK
Agent receiving traces<N> trace(s)/min in APM receiverOK
APM service visible<SERVICE_NAME> in env <ENV>OK
Traces arriving<N> trace(s) found in the last hourOK
Data Streams (only if enabled)data_streams.latency series for <SERVICE_NAME>, or "pending first message"OK

Your service in Datadog — click to open:

Construct each URL by substituting real values. Do not print placeholder URLs.

ViewURL
Service overviewhttps://app.<DD_SITE>/apm/services/<SERVICE_NAME>?env=<ENV>
Traces explorerhttps://app.<DD_SITE>/apm/traces?query=service:<SERVICE_NAME>%20env:<ENV>
Service maphttps://app.<DD_SITE>/apm/map?env=<ENV>&service=<SERVICE_NAME>
Infrastructure hosthttps://app.<DD_SITE>/infrastructure?q=host:<HOSTNAME>
Agent fleethttps://app.<DD_SITE>/fleet-automation
Data Streams (only if enabled)https://app.<DD_SITE>/data-streams

Security constraints

  • Never write a raw API key into any file or chat message

© datadog-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in dd-apm/linux-ssi/onboarding-summary of datadog-labs/agent-skills.

Open the folder on GitHubat commit d2411cc

Compare with similar skills

Onboarding Summary 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.

Onboarding Summary compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Onboarding Summary this skilldatadog-labs/agent-skills177—~1.2kAutomated safety check: NotesMIT
Bump LibdatadogDataDog/dd-trace-dotnet572—~1.7kAutomated safety check: PassApache-2.0
Apm IntegrationsDataDog/dd-trace-js837—~3kAutomated safety check: PassCustom licence
Apm IntegrationsDataDog/dd-trace-java736—~3.7kAutomated safety check: NotesApache-2.0
Azure FunctionsDataDog/dd-trace-dotnet572—~4.7kAutomated safety check: PassApache-2.0
Tool ConnectorZhixiangLuo/10xProductivity479—~925Automated safety check: PassMIT

Similar skills

  • Bump Libdatadog

    DataDog/dd-trace-dotnet

    Official

    Update/bump the libdatadog native library version in dd-trace-dotnet.

    572 GitHub stars~1.7k tokensUpdated today
    Auto-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.

    837 GitHub stars~3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Apm Integrations

    DataDog/dd-trace-java

    Official

    Write a new library instrumentation end-to-end. An agent skill from DataDog/dd-trace-java.

    736 GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Azure Functions

    DataDog/dd-trace-dotnet

    Official

    Dev/test workflow for tracer engineers working on the Datadog .NET tracer — build a local Datadog.AzureFunctions NuGet package, deploy it to a test Azure Function App, trigger it, and analyze…

    572 GitHub stars~4.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Tool Connector

    ZhixiangLuo/10xProductivity

    Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…

    479 GitHub stars~925 tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Redis Observability

    redis/agent-skills

    Official

    Redis observability guidance — which metrics to monitor (memory, connections, hit ratio, ops/sec, rejected connections), which built-in commands to reach for during incident triage (SLOWLOG, INFO…

    166 GitHub starsUsed in 2 repos~911 tokens
    DevOps & CloudAuto-check passed

More from datadog-labs/agent-skills

All 39 skills in this repo
  • Bootstrap a reproducible LLM Observability experiment through the Python ddtrace SDK or the Node dd-trace SDK.

    177 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Dd Account Setup

    datadog-labs/agent-skills

    Ensure the user has an authenticated Datadog account with a valid DDAPIKEY on the right region before any Datadog setup or instrumentation.

    177 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check: notes
  • Dd Orchestrator

    datadog-labs/agent-skills

    Entry point for Datadog onboarding. An agent skill from datadog-labs/agent-skills.

    177 GitHub stars~6.7k tokensUpdated yesterday
    Auto-check passed
  • Dd Apm

    datadog-labs/agent-skills

    APM - install, onboard, instrument, enable, set up, configure, traces, services, dependencies, performance analysis, Data Streams Monitoring (DSM), queue lag, pipeline latency.

    177 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Agent Install

    datadog-labs/agent-skills

    Install the Datadog Agent on Kubernetes using the Datadog Operator — required before enabling Single Step Instrumentation (SSI), which automatically instruments applications for APM without code…

    177 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check: warnings
  • Dd AWS Integration

    datadog-labs/agent-skills

    Set up the Datadog AWS integration with Terraform - creates the cross-account IAM role Datadog assumes (external ID, no stored credentials), attaches the permission policies Datadog publishes, and…

    177 GitHub stars~6.8k tokensUpdated yesterday
    Auto-check: notes

Works with

Categories

Questions about Onboarding Summary

What does Onboarding Summary do?

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI. Onboarding Summary is an agent skill from datadog-labs/agent-skills. Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI.

When should I use Onboarding Summary?

Onboarding Summary fits situations like: tasks that involve Monitoring and alerting.

How do I install Onboarding Summary in Claude Code?

Run `npx skills add datadog-labs/agent-skills --skill onboarding-summary -a claude-code`. Or copy the skill folder (dd-apm/linux-ssi/onboarding-summary in datadog-labs/agent-skills) into .claude/skills/onboarding-summary in your project. Claude Code loads it when a task matches its description.

How do I install Onboarding Summary in Codex?

Run `npx skills add datadog-labs/agent-skills --skill onboarding-summary -a codex`. Or copy the skill folder (dd-apm/linux-ssi/onboarding-summary in datadog-labs/agent-skills) into .agents/skills/onboarding-summary in your project. Codex loads it when a task matches its description.

Can I use Onboarding Summary 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-labs/agent-skills --skill onboarding-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/onboarding-summary, .gemini/skills/onboarding-summary, .github/skills/onboarding-summary and .opencode/skills/onboarding-summary in your project.

What does Onboarding Summary need to run?

Going by SKILL.md and its folder, Onboarding Summary needs the command-line tools its instructions call (ssh) and credentials named SSH_KEY. Our summary lists: A credential in SSH_KEY.

Does Onboarding Summary access the network?

SKILL.md contains no URLs. Its commands use ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Onboarding Summary safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Onboarding Summary use?

Onboarding Summary is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Onboarding Summary use?

About 1.2k tokens (SKILL.md is roughly 5k 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 Onboarding Summary?

Skills that share tags, products or a category with Onboarding Summary: Bump Libdatadog (DataDog/dd-trace-dotnet, 572 stars), Apm Integrations (DataDog/dd-trace-js, 837 stars), Apm Integrations (DataDog/dd-trace-java, 736 stars) and Azure Functions (DataDog/dd-trace-dotnet, 572 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Onboarding Summary?

datadog-labs (a GitHub organization) maintains it in datadog-labs/agent-skills, which has 177 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 8, 2026.

Source: datadog-labs/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.