Agent skill

Deep Researcher Prepare PR

by NVIDIA-AI-Blueprints in NVIDIA-AI-Blueprints/deep-researcher-agent

A skill your agent uses when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation…

Apache-2.0Auto-check: notesDevelopment

Install Deep Researcher Prepare PR

skills CLI
$ npx skills add NVIDIA-AI-Blueprints/deep-researcher-agent --skill deep-researcher-prepare-pr -a claude-code

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

GitHub CLI
$ gh skill install NVIDIA-AI-Blueprints/deep-researcher-agent deep-researcher-prepare-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/NVIDIA-AI-Blueprints/deep-researcher-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deep-researcher-prepare-pr .claude/skills/deep-researcher-prepare-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
deep-researcher-prepare-pr
GitHub stars
886
Token cost
~1k tokens
SKILL.md length
423 words
Files
2 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation…

  • Works in 7 steps: Verify the branch is focused and based… → Ensure every commit is signed: git… → Run the relevant checks via… → …
  • Updating an Deep Researcher Agent pull request — scoping the branch
  • SKILL.md covers Start Here, Authoritative References, Workflow and Validation, plus 2 more sections
  • Calls git

What it does

Deep Researcher Prepare PR is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent. Use when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation evidence, and following the copy-pr-bot CI and merge flow.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/pr-checklist.md`). Compatibility notes: Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools.

It sits in Development, covering Pull requests. The repository describes itself as: The NVIDIA Deep Researcher Agent Blueprint is an open reference example for building intelligent AI agents that connect to your enterprise data, reason using state-of-the-art… The licence is Apache-2.0.

When your agent uses it

  • Updating an Deep Researcher Agent pull request — scoping the branch
  • Signing commits with DCO
  • Filling the PR template with real validation evidence
  • Following the copy-pr-bot CI and merge flow

Example prompts

  • “/deep-researcher-prepare-pr”

Requirements

  • Compatibility (from SKILL.md): Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools.
  • Pre-approved tools (allowed-tools): Read, Bash, Edit

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Verify the branch is focused and based on develop; rebase or reset scope if
  2. Ensure every commit is signed: git commit -s (and git commit --amend -s
  3. Run the relevant checks via deep-researcher-release-qa and keep the exact output.
  4. Push the branch and open the PR into develop.
  5. Fill the PR template: Overview, Validation (paste the commands and output),
  6. Drive CI: a maintainer or vetter comments /ok to test, copy-pr-bot mirrors
  7. Address review feedback until required checks and code-owner review pass.

What it can do on your machine

Read from SKILL.md and the folder at commit 951a1a1. 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
    • Bash
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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.

  • Compatibility

    Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools.

    From compatibility in the SKILL.md frontmatter.

Context cost

Deep Researcher Prepare PR loads about 1k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 423 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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: notes

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

  • NoteMentions a .env fileSKILL.md:80
    - Committing secrets or `deploy/.env` values. Resolve secrets at runtime; never
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Edit

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 NVIDIA-AI-Blueprints/deep-researcher-agent at commit 951a1a1, republished under its Apache-2.0 licence (© NVIDIA-AI-Blueprints). 423 words, ~1,022 tokens.

Download SKILL.mdSave it as .claude/skills/deep-researcher-prepare-pr/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deep-researcher-prepare-pr
description
Use when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation evidence, and following the copy-pr-bot CI and merge flow.
allowed-tools
Read, Bash, Edit
compatibility
Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools.
license
Apache-2.0
metadata.version
0.1.0
metadata.source-repo
NVIDIA-AI-Blueprints/deep-researcher-agent
metadata.tags
deep-researcher pull-request dco contributing release-qa

Prepare an Deep Researcher Agent Pull Request

Use this skill to take a finished Deep Researcher Agent change from a working branch to a review-ready pull request: a focused branch off develop, DCO-signed commits, the PR template filled with real validation evidence, and the copy-pr-bot CI flow followed correctly.

Start Here

  • Confirm the change is scoped: no unrelated files, no generated artifacts, no secrets, no environment-specific hostnames.
  • Confirm validation already ran. This skill does not invent test commands — run deep-researcher-release-qa first and reuse its exact output as evidence.
  • Confirm every commit is signed off (DCO). Commits without a Signed-off-by trailer may be rejected.
  • Target the develop branch unless a maintainer asked for a release branch.

Authoritative References

  • CONTRIBUTING.md: the canonical PR workflow, Local Validation, DCO text, and the copy-pr-bot / /ok to test / /merge flow.
  • .github/pull_request_template.md: the exact sections and checklist your PR description must fill.
  • AGENTS.md: "Git and PR hygiene" and the validation commands deep-researcher-release-qa runs.

For the step-by-step checklist and the bot command reference:

Workflow

  1. Verify the branch is focused and based on develop; rebase or reset scope if unrelated files crept in.
  2. Ensure every commit is signed: git commit -s (and git commit --amend -s or git rebase --signoff to fix unsigned commits already made).
  3. Run the relevant checks via deep-researcher-release-qa and keep the exact output.
  4. Push the branch and open the PR into develop.
  5. Fill the PR template: Overview, Validation (paste the commands and output), reviewer starting point, related issues, and tick every checklist box you can honestly tick.
  6. Drive CI: a maintainer or vetter comments /ok to test, copy-pr-bot mirrors the PR to pull-request/<number>, and CI runs there.
  7. Address review feedback until required checks and code-owner review pass.
Show full SKILL.md (133 more words)Show less

Validation

This skill is about PR hygiene, not code execution; verify the contributor mechanics:

bash
git log --pretty=full origin/develop..HEAD | grep -c "Signed-off-by:"  # every commit signed
git diff --name-only origin/develop..HEAD                              # only intended files
git status --porcelain                                                 # no stray artifacts

Expected: the sign-off count equals your commit count, the changed-file list contains only files relevant to this change, and the working tree is clean.

Common Mistakes

  • Unsigned commits. Use git commit -s; fix existing ones with git rebase --signoff origin/develop before pushing.
  • A vague Validation section. Paste the real commands and their output from deep-researcher-release-qa; "ran tests" is not evidence.
  • Scope creep: unrelated refactors, formatting churn on untouched files, or committed generated artifacts.
  • Committing secrets or deploy/.env values. Resolve secrets at runtime; never paste them into the PR.
  • Expecting CI to run on push alone — it runs on the copy-pr-bot mirror after /ok to test.
  • Skipping the docs update for user-facing or contributor-facing changes.
  • deep-researcher-release-qa
  • deep-researcher-add-tool
  • deep-researcher-add-data-source

© NVIDIA-AI-Blueprints, 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

SKILL.md and 1 other file (references) in .agents/skills/deep-researcher-prepare-pr of NVIDIA-AI-Blueprints/deep-researcher-agent.

  • SKILL.md
  • references/pr-checklist.md

Open the folder on GitHubat commit 951a1a1

Compare with similar skills

Deep Researcher Prepare 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.

Deep Researcher Prepare PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Researcher Prepare PR this skillNVIDIA-AI-Blueprints/deep-researcher-agent886—~1kAutomated safety check: NotesApache-2.0
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands91k—~2.4kAutomated safety check: PassMIT
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    91k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Record PR Demo

    payloadcms/payload

    A skill your agent uses when a Payload pull request needs a concise visual walkthrough for reviewers.

    45k GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from NVIDIA-AI-Blueprints/deep-researcher-agent

All 15 skills in this repo
  • Deep Researcher Configure Workflow

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when composing, adapting, or validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile, enabling tools and datasourceregistry sources…

    886 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Deep Researcher Research

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when asked to run deep research or Deep Researcher Agent research through a reachable NVIDIA Deep Researcher Agent Blueprint backend.

    886 GitHub stars~4.4k tokensUpdated yesterday
    Auto-check: notes
  • Deep Researcher Add Data Source

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when adding or changing an Deep Researcher Agent data source under sources/, registering it as a NeMo Agent Toolkit function, wiring it into the datasourceregistry for UI…

    886 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Deep Researcher Add Tool

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when adding or changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/, defining its FunctionBaseConfig schema, registering it…

    886 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Deep Researcher Customize Prompts Models

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when customizing Deep Researcher Agent behavior through Jinja2 prompt templates or per-agent model selection — editing prompts under src/deepresearcheragent/agents//prompts/…

    886 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Deep Researcher Deploy

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA Deep Researcher Agent Blueprint infrastructure.

    886 GitHub stars~3.5k tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about Deep Researcher Prepare PR

What does Deep Researcher Prepare PR do?

A skill your agent uses when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation…. Deep Researcher Prepare PR is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent. Use when preparing, opening, or updating an Deep Researcher Agent pull request — scoping the branch, signing commits with DCO, filling the PR template with real validation evidence, and following the copy-pr-bot CI and merge flow.

When should I use Deep Researcher Prepare PR?

Deep Researcher Prepare PR fits situations like: updating an Deep Researcher Agent pull request — scoping the branch; signing commits with DCO; filling the PR template with real validation evidence; following the copy-pr-bot CI and merge flow.

How do I install Deep Researcher Prepare PR in Claude Code?

Run `npx skills add NVIDIA-AI-Blueprints/deep-researcher-agent --skill deep-researcher-prepare-pr -a claude-code`. Or copy the skill folder (.agents/skills/deep-researcher-prepare-pr in NVIDIA-AI-Blueprints/deep-researcher-agent) into .claude/skills/deep-researcher-prepare-pr in your project. Claude Code loads it when a task matches its description.

How do I install Deep Researcher Prepare PR in Codex?

Run `npx skills add NVIDIA-AI-Blueprints/deep-researcher-agent --skill deep-researcher-prepare-pr -a codex`. Or copy the skill folder (.agents/skills/deep-researcher-prepare-pr in NVIDIA-AI-Blueprints/deep-researcher-agent) into .agents/skills/deep-researcher-prepare-pr in your project. Codex loads it when a task matches its description.

Can I use Deep Researcher Prepare 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 NVIDIA-AI-Blueprints/deep-researcher-agent --skill deep-researcher-prepare-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/deep-researcher-prepare-pr, .gemini/skills/deep-researcher-prepare-pr, .github/skills/deep-researcher-prepare-pr and .opencode/skills/deep-researcher-prepare-pr in your project.

What does Deep Researcher Prepare PR need to run?

Going by SKILL.md and its folder, Deep Researcher Prepare PR needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Read, Bash, Edit. Compatibility (from SKILL.md): Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools..

Does Deep Researcher Prepare PR access the network?

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

Is Deep Researcher Prepare PR safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; 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 Deep Researcher Prepare PR use?

Deep Researcher Prepare PR is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deep Researcher Prepare PR use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 713 tokens, read only when the agent opens those files.

What are the alternatives to Deep Researcher Prepare PR?

Skills that share tags, products or a category with Deep Researcher Prepare PR: Finishing a Development Branch (obra/superpowers, 297k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars) and PR Design Doc (OpenHands/OpenHands, 91k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Researcher Prepare PR?

NVIDIA-AI-Blueprints (a GitHub organization) maintains it in NVIDIA-AI-Blueprints/deep-researcher-agent, which has 886 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

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