Official agent skill

Cws Btfhub Sync

by DataDog in DataDog/datadog-agent

Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it.

OfficialApache-2.0Auto-check: notes

Install Cws Btfhub Sync

skills CLI
$ npx skills add DataDog/datadog-agent --skill cws-btfhub-sync -a claude-code

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

GitHub CLI
$ gh skill install DataDog/datadog-agent cws-btfhub-sync --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/datadog-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cws-btfhub-sync .claude/skills/cws-btfhub-sync && 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
cws-btfhub-sync
GitHub stars
3.8k
Token cost
~600 tokens
SKILL.md length
265 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
Apache-2.0

At a glance

Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it.

  • KMT secagent jobs log failed to fetch constant for <name
  • SKILL.md covers Run it, Wait for it and Land it
  • Calls gh

What it does

Cws Btfhub Sync is an agent skill from DataDog/datadog-agent, published by the product's own GitHub organization. Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it. Use when KMT secagent jobs log "failed to fetch constant for <name".

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

The repository describes itself as: Main repository for Datadog Agent. The licence is Apache-2.0.

When your agent uses it

  • KMT secagent jobs log failed to fetch constant for <name

Example prompts

  • “failed to fetch constant for <name”
  • “/cws-btfhub-sync”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Bash, AskUserQuestion

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Bash
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Cws Btfhub Sync loads about 600 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 265 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Bash, AskUserQuestion

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/datadog-agent at commit a706f1a, republished under its Apache-2.0 licence (© DataDog). 265 words, ~600 tokens.

Download SKILL.mdSave it as .claude/skills/cws-btfhub-sync/SKILL.md (or your agent's skills folder).
name
cws-btfhub-sync
description
Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it. Use when KMT secagent jobs log "failed to fetch constant for <name>".
allowed-tools
Read, Grep, Bash, AskUserQuestion
model
sonnet

Syncing CWS BTFHub constants

A new appendOffsetofRequest in probe_ebpf.go resolves via BTF on modern kernels, but pre-BTF kernels read the offset from the checked-in, arch-split constants:

  • pkg/security/probe/constantfetch/constants_amd64.json
  • pkg/security/probe/constantfetch/constants_arm64.json

These predate your change and so lack the new entry. Regenerating them is the fix.

Run it

bash
gh workflow run cws-btfhub-sync.yml --ref main -f base_branch=<your-feature-branch>

The trap: --ref selects the workflow definition — keep it main. base_branch is the ref the generate and combine jobs check out, and the base of the PR it opens. Leave base_branch at its main default and the generator never sees your new offset requests: the sync yields an empty diff and it looks like btfhub simply lacks the offsets.

Before running, confirm the failing distros are covered by the cone matrix in .github/workflows/cws-btfhub-sync.yml.

Wait for it

It is a ~15-job matrix and takes tens of minutes. Poll it from a background shell so the wait costs nothing and you get re-invoked on exit:

bash
until [ "$(gh run view <run-id> --json status -q .status)" = completed ]; do sleep 60; done
gh run view <run-id> --json conclusion -q .conclusion

Do not run gh run watch in the foreground (it outlives the tool timeout) and do not chain short sleeps in the main loop. When the notification arrives, carry straight on to Land it in the same turn — this is one task, not a hand-off.

Land it

On success the workflow opens a PR titled CWS: sync BTFHub constants from a cws/constants-sync-* branch, targeting your branch:

bash
gh pr list --search "CWS: sync BTFHub constants" --state open --json number,baseRefName,url

From the list, select the <number> that has the baseRefName equal to this feature branch and merge it directly (gh pr merge <number> --merge); feature branches carry no protection rule, so this needs no approval.

Confirm the merged commit touches btfhub/constants.json and that your new offset names appear in the diff.

© DataDog, Apache-2.0. 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 .agents/skills/cws-btfhub-sync of DataDog/datadog-agent.

Open the folder on GitHubat commit a706f1a

Compare with similar skills

Cws Btfhub Sync 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.

Cws Btfhub Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cws Btfhub Sync this skillDataDog/datadog-agent3.8k—~600Automated safety check: NotesApache-2.0
React Syncvercel/next.js143k—~486Automated safety check: PassMIT
Claude-Mem Cloud Syncthedotmack/claude-mem99k—~1kAutomated safety check: NotesApache-2.0
Agent Sync Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT
Fix SyncClickHouse/ClickHouse50k—~2.8kAutomated safety check: PassApache-2.0
I18n Syncaffaan-m/ECC276k—~1.8kAutomated safety check: PassMIT

Similar skills

  • React Sync

    vercel/next.js

    Official

    Build local React changes in the bundle variants consumed by Next.js, sync them into a local Next.js checkout, and test the resulting integration.

    143k GitHub stars~486 tokensUpdated today
    Auto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    99k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • Fix Sync

    ClickHouse/ClickHouse

    Fix the "CH Inc sync" job in a pull request. An agent skill from ClickHouse/ClickHouse.

    50k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • I18n Sync

    affaan-m/ECC

    Translate and synchronize application JSON locale files using source-key usage, project terminology, and focused validation.

    276k GitHub stars~1.8k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Agent skill for project-board-sync - invoke with $agent-project-board-sync

    74k GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed

More from DataDog/datadog-agent

All 35 skills in this repo
  • 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
    Auto-check passed
  • Elicit

    DataDog/datadog-agent

    Official

    Run a structured discovery session to build an Allium specification through conversation.

    3.8k GitHub starsUsed in 1 repo~3.7k tokens
    Auto-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
    Auto-check passed
  • Create Epic Recap

    DataDog/datadog-agent

    Official

    A skill your agent uses when an engineer or manager asks to recap, summarize, or post an update on a Jira Epic — a progress update for an in-progress Epic (how far along it is, what's shipped so…

    3.8k GitHub stars~5k tokensUpdated today
    Auto-check: notes
  • Explain Lading Config

    DataDog/datadog-agent

    Official

    Explains a lading.yaml config file from the regression test suite, using the lading Rust source as ground truth for field meanings and defaults.

    3.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Distill

    DataDog/datadog-agent

    Official

    Extract an Allium specification from an existing codebase. An agent skill from DataDog/datadog-agent.

    3.8k GitHub starsUsed in 1 repo~7k tokens
    Auto-check passed

Questions about Cws Btfhub Sync

What does Cws Btfhub Sync do?

Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it. Cws Btfhub Sync is an agent skill from DataDog/datadog-agent, published by the product's own GitHub organization. Sync CWS BTFHub constants after adding a new constantfetch offset, so pre-BTF kernels can resolve it.

When should I use Cws Btfhub Sync?

Cws Btfhub Sync fits situations like: KMT secagent jobs log failed to fetch constant for <name.

How do I install Cws Btfhub Sync in Claude Code?

Run `npx skills add DataDog/datadog-agent --skill cws-btfhub-sync -a claude-code`. Or copy the skill folder (.agents/skills/cws-btfhub-sync in DataDog/datadog-agent) into .claude/skills/cws-btfhub-sync in your project. Claude Code loads it when a task matches its description.

How do I install Cws Btfhub Sync in Codex?

Run `npx skills add DataDog/datadog-agent --skill cws-btfhub-sync -a codex`. Or copy the skill folder (.agents/skills/cws-btfhub-sync in DataDog/datadog-agent) into .agents/skills/cws-btfhub-sync in your project. Codex loads it when a task matches its description.

Can I use Cws Btfhub Sync 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/datadog-agent --skill cws-btfhub-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cws-btfhub-sync, .gemini/skills/cws-btfhub-sync, .github/skills/cws-btfhub-sync and .opencode/skills/cws-btfhub-sync in your project.

What does Cws Btfhub Sync need to run?

Going by SKILL.md and its folder, Cws Btfhub Sync needs the command-line tools its instructions call (gh). Its frontmatter pre-approves these tools: Read, Grep, Bash, AskUserQuestion.

Does Cws Btfhub Sync access the network?

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

Is Cws Btfhub Sync safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Cws Btfhub Sync use?

Cws Btfhub Sync 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 Cws Btfhub Sync use?

About 600 tokens (SKILL.md is roughly 2.4k 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 Cws Btfhub Sync?

Skills that share tags, products or a category with Cws Btfhub Sync: React Sync (vercel/next.js, 143k stars), Claude-Mem Cloud Sync (thedotmack/claude-mem, 99k stars), Agent Sync Coordinator (ruvnet/ruflo, 74k stars) and Fix Sync (ClickHouse/ClickHouse, 50k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cws Btfhub Sync?

DataDog (a GitHub organization, an official publisher) maintains it in DataDog/datadog-agent, which has 3,759 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 9, 2026.

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