Official agent skill

Dd Unblock PR

by DataDog in DataDog/pup

Load when investigating a failing PR CI pipeline or checking PR health.

OfficialApache-2.0Auto-check passedTesting & QA

Install Dd Unblock PR

skills CLI
$ npx skills add DataDog/pup --skill dd-unblock-pr -a claude-code

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

GitHub CLI
$ gh skill install DataDog/pup dd-unblock-pr --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-unblock-pr .claude/skills/dd-unblock-pr && 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
dd-unblock-pr
GitHub stars
1k
Token cost
~1.7k tokens
SKILL.md length
587 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Load when investigating a failing PR CI pipeline or checking PR health.

  • Works in 7 steps: Parse Input → Get PR CI Summary (run both in parallel) → 5 — Fetch Code Coverage (run in parallel… → …
  • Tasks that involve Test coverage
  • SKILL.md covers Input and Workflow
  • Calls git and gh; reaches github.com

What it does

Dd Unblock PR is an agent skill from DataDog/pup, published by the product's own GitHub organization. Load when investigating a failing PR CI pipeline or checking PR health. Attributes each CI failure as flaky, infra, or regression, proposes a targeted action, and reports code coverage.

Its SKILL.md is about 1.7k 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 Testing & QA, covering Test coverage, Failing and flaky tests and CI/CD. 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.

When your agent uses it

  • Tasks that involve Test coverage
  • Tasks that involve Failing and flaky tests
  • Tasks that involve CI/CD

Example prompts

  • “/dd-unblock-pr”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Parse Input
  2. Get PR CI Summary (run both in parallel)
  3. 5 — Fetch Code Coverage (run in parallel with STEP 1)
  4. Blame Guard per Failing Job
  5. Classify Each Failure
  6. Produce Triage Brief
  7. Propose Actions

What it can do on your machine

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

    • git
    • gh

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Dd Unblock PR loads about 1.7k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 587 words of instructions outside code blocks.

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

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 c075375, republished under its Apache-2.0 licence (© DataDog). 587 words, ~1,667 tokens.

Download SKILL.mdSave it as .claude/skills/dd-unblock-pr/SKILL.md (or your agent's skills folder).
name
dd-unblock-pr
description
Load when investigating a failing PR CI pipeline or checking PR health. Attributes each CI failure as flaky, infra, or regression, proposes a targeted action, and reports code coverage.
metadata.version
1.1.0
metadata.author
datadog-labs
metadata.repository
https://github.com/datadog-labs/agent-skills
metadata.tags
datadog,ci,cicd,flaky,flaky-tests,pipeline
metadata.alwaysApply
false

Unblock PR

One-line summary: Investigate a failing PR CI pipeline — attribute each failure as flaky, infra, or regression and propose a targeted action.

Requires: dd-pup skill (pup CLI installed and authenticated), dd-triage-flaky-test skill (for flaky failure deep investigation).


Input

ParameterDescription
PR branchThe branch under investigation (e.g. my-feature-branch)
RepositoryLowercase, no-schema URL (e.g. github.com/org/repo). Derive from git remote get-url origin if not provided.

Workflow

STEP 0 — Parse Input

Derive repository ID and default branch from git if not provided:

bash
# Repository ID: fully lowercase, no-schema URL (the API rejects mixed-case)
git remote get-url origin
# Strip protocol and trailing .git, then lowercase the result
# e.g. https://github.com/DataDog/my-repo.git → github.com/datadog/my-repo

# Default branch
git symbolic-ref refs/remotes/origin/HEAD
# Strip refs/remotes/origin/ prefix — fall back to main if unset
STEP 1 — Get PR CI Summary (run both in parallel)

Pipeline failures (job level):

bash
pup cicd events search \
  --query "@ci.status:error @git.branch:<branch> @git.repository.id_v2:\"<repo>\"" \
  --level job \
  --from 24h \
  --limit 50

Test failures:

bash
pup cicd tests search \
  --query "@test.status:fail @git.branch:<branch> @git.repository.id_v2:\"<repo>\"" \
  --from 24h \
  --limit 50

Run both queries in parallel. Collect all distinct @test.service values from test event results. If more than one distinct service is found, note each separately in the triage brief — do not collapse them into a single service filter. If pipeline results contain only infrastructure job types (build, lint, deploy) with no test-runner output, discard test search results and skip to STEP 3.

STEP 1.5 — Fetch Code Coverage (run in parallel with STEP 1)

This step runs unconditionally — coverage context is valuable whether CI is red or green.

The --repo value must be fully lowercase (the API rejects mixed-case). Normalize before calling:

bash
repo_lower=$(echo "<repo>" | tr '[:upper:]' '[:lower:]')
pup code-coverage branch-summary \
  --repo "$repo_lower" \
  --branch "<branch>"

If the command returns no data or exits with an error, report "No data available" for Coverage in the PR Health section.

Note: Code quality and security violation counts are not available in pup — those lines always show "No data available".

STEP 2 — Blame Guard per Failing Job

First check whether @error_classification.domain / @error_classification.type are present on job events from STEP 1 — if populated, use them as primary classification signals.

For each failing job where classification is still needed, run both checks in parallel:

Default branch check — was this job already failing before this PR?

bash
pup cicd events aggregate \
  --query "@ci.status:error @ci.job.name:\"<job>\" @git.branch:<default-branch> @git.repository.id_v2:\"<repo>\"" \
  --compute count \
  --from 24h

Blast radius check — is this job failing on other branches too?

bash
pup cicd events aggregate \
  --query "@ci.status:error @ci.job.name:\"<job>\" @git.repository.id_v2:\"<repo>\"" \
  --compute count \
  --group-by "@git.branch" \
  --from 24h

Performance fallback: if the blast radius query is slow or times out, skip it and rely on the default branch check alone.

Show full SKILL.md (272 more words)Show less
STEP 3 — Classify Each Failure

Priority order:

  1. If @error_classification.domain / @error_classification.type present → use as primary signal
  2. If test failure AND test appears in flaky tests with flaky_test_state:active:
    bash
    pup cicd flaky-tests search \
      --query "flaky_test_state:active @test.name:\"<test-name>\" @git.repository.id_v2:\"<repo>\""
    → flaky
  3. Use blame guard results:
Failing on default branch?Failing on ≥3 other branches?Classification
YesYesinfra (pre-existing, widespread)
YesNoinfra (pre-existing on default branch)
NoNoregression (introduced by this PR)
NoYesflaky (intermittent, cross-branch)
Insufficient data—unknown
STEP 4 — Produce Triage Brief

One entry per failing job:

PR CI Triage Brief
==================
Branch:   <branch>
Repo:     <repo>

Job: <job-name>
  Classification:  <flaky | infra | regression | unknown>
  Evidence:        <1 key data point — error message, pipeline count, or test result>
  Confidence:      <high | medium | low>
  Recommended:     <action>

[repeat for each failing job]

Overall: <N> failures — <e.g. "1 regression, 1 flaky, 1 infra">

PR Health
=========
Coverage:   <X>% on <branch> | No data available
Quality:    No data available
Security:   No data available

All three lines always appear.

STEP 5 — Propose Actions

regression → Prompt user to investigate their code changes. No write action available.

flaky → Load dd-triage-flaky-test skill for deep investigation. That skill will:

  • Attempt an agent-native fix using flaky_category + stack trace
  • Propose quarantine via pup test-optimization flaky-tests update if a quick fix isn't possible

infra → Before proposing a retry, assess whether the failure is transient:

  • Check @error_classification.type and error message for signals like timeout, runner unavailable, network error, quota exceeded — these indicate transient failures where a retry is likely to help
  • If the error is deterministic (build misconfiguration, missing secret, explicit test assertion failure), a retry is unlikely to help — note this and suggest investigating the root cause
  • If the failure is pre-existing on the default branch, inform the user — a retry will likely fail again; await the upstream fix instead

If transient and GitHub Actions: extract the run ID from @ci.pipeline.url (e.g. https://github.com/org/repo/actions/runs/<run_id>):

bash
gh run rerun <run_id> --failed

For other providers, share @ci.pipeline.url and direct to the provider UI for retry.

unknown → Suggest checking raw job logs via the CI provider UI or @ci.pipeline.url from the pipeline event.

© 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 skills/dd-unblock-pr of DataDog/pup.

Open the folder on GitHubat commit c075375

Compare with similar skills

Dd Unblock PR 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 Unblock PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dd Unblock PR this skillDataDog/pup1k—~1.7kAutomated safety check: PassApache-2.0
Unblock PRdatadog-labs/agent-skills177—~2.7kAutomated safety check: PassMIT
QA Metricspetrkindlmann/qa-skills168—~5.3kAutomated safety check: PassMIT
Matlab Run Testsmatlab/matlab-agentic-toolkit1.1k—~1.6kAutomated safety check: PassCustom licence
Test Automation Strategyproffesor-for-testing/agentic-qe495—~1.4kAutomated safety check: PassMIT
Qcsd Cicd Swarmproffesor-for-testing/agentic-qe495—~2.3kAutomated safety check: PassMIT

Similar skills

  • Unblock PR

    datadog-labs/agent-skills

    Load when investigating a failing PR CI pipeline or checking PR health.

    177 GitHub stars~2.7k tokensUpdated today
    Testing & QAAuto-check passed
  • QA Metrics

    petrkindlmann/qa-skills

    Define, track, and act on QA metrics: test coverage percentage, flakiness rate, defect escape rate, MTTR, test execution time trends, automation ROI, quality gates, and SLAs for test suites.

    168 GitHub stars~5.3k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Matlab Run Tests

    matlab/matlab-agentic-toolkit

    Run MATLAB test suites and analyze results, including test filtering, parallel execution, result diagnostics, code coverage collection, gap analysis, and CI/CD with buildtool.

    1.1k GitHub stars~1.6k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Test Automation Strategy

    proffesor-for-testing/agentic-qe

    Design and implement effective test automation with proper pyramid, patterns, and CI/CD integration.

    495 GitHub stars~1.4k tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • Qcsd Cicd Swarm

    proffesor-for-testing/agentic-qe

    A skill your agent uses when enforcing CI/CD quality gates before release, running regression analysis, detecting flaky tests, or assessing deployment readiness in the QCSD Verification phase.

    495 GitHub stars~2.3k tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • Qe Test Automation Strategy

    proffesor-for-testing/agentic-qe

    Design and implement effective test automation with proper pyramid, patterns, and CI/CD integration.

    495 GitHub stars~1.6k tokensUpdated 4 days ago
    Testing & QAAuto-check passed

More from DataDog/pup

All 12 skills in this repo
  • Dd Idp

    DataDog/pup

    Official

    Find, filter, count, and connect software, teams, engineering work and delivery, infrastructure, and operational or security records through Pup's read-only Datadog entity graph.

    1k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Dd Debugger

    DataDog/pup

    Official

    Live Debugger - inspect runtime argument/variable values in production by placing log probes on methods.

    1k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Dd Docs

    DataDog/pup

    Official

    Datadog docs lookup using docs.datadoghq.com/llms.txt and linked Markdown pages.

    1k GitHub starsUsed in 1 repo~558 tokens
    Auto-check passed
  • Pup

    DataDog/pup

    Official

    Datadog API CLI with 49 command groups, 300+ subcommands. An agent skill from DataDog/pup.

    1k GitHub stars~523 tokensUpdated today
    Auto-check passed
  • Official

    Load when investigating a specific flaky test. An agent skill from DataDog/pup.

    1k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Dd Apm

    DataDog/pup

    Official

    APM - traces, services, dependencies, performance analysis. An agent skill from DataDog/pup.

    1k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Dd Unblock PR

What does Dd Unblock PR do?

Load when investigating a failing PR CI pipeline or checking PR health. Dd Unblock PR is an agent skill from DataDog/pup, published by the product's own GitHub organization. Load when investigating a failing PR CI pipeline or checking PR health.

When should I use Dd Unblock PR?

Dd Unblock PR fits situations like: tasks that involve Test coverage; tasks that involve Failing and flaky tests; tasks that involve CI/CD.

How do I install Dd Unblock PR in Claude Code?

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

How do I install Dd Unblock PR in Codex?

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

Can I use Dd Unblock PR 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-unblock-pr -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-unblock-pr, .gemini/skills/dd-unblock-pr, .github/skills/dd-unblock-pr and .opencode/skills/dd-unblock-pr in your project.

What does Dd Unblock PR need to run?

Going by SKILL.md and its folder, Dd Unblock PR needs the command-line tools its instructions call (git and gh).

Does Dd Unblock PR access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Dd Unblock PR 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 Unblock PR use?

Dd Unblock PR 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 Unblock PR use?

About 1.7k tokens (SKILL.md is roughly 6.7k 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 Unblock PR?

Skills that share tags, products or a category with Dd Unblock PR: Unblock PR (datadog-labs/agent-skills, 177 stars), QA Metrics (petrkindlmann/qa-skills, 168 stars), Matlab Run Tests (matlab/matlab-agentic-toolkit, 1.1k stars) and Test Automation Strategy (proffesor-for-testing/agentic-qe, 495 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dd Unblock PR?

DataDog (a GitHub organization, an official publisher) maintains it in DataDog/pup, which has 1,028 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 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.