Agent skill

Deep Researcher Add Tool

by NVIDIA-AI-Blueprints in 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…

Apache-2.0Auto-check: notes

Install Deep Researcher Add Tool

skills CLI
$ npx skills add NVIDIA-AI-Blueprints/deep-researcher-agent --skill deep-researcher-add-tool -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-add-tool --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-add-tool .claude/skills/deep-researcher-add-tool && 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-add-tool
GitHub stars
886
Token cost
~1.1k tokens
SKILL.md length
475 words
Files
3 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • Works in 8 steps: Pick the closest existing package under… → Create sources// with src/register.py, a… → Define a FunctionBaseConfig subclass… → …
  • Changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/
  • SKILL.md covers Start Here, Authoritative References, Workflow and Validation, plus 2 more sections
  • Calls uv

What it does

Deep Researcher Add Tool is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent. Use when adding or changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/, defining its FunctionBaseConfig schema, registering it with @registerfunction, wiring it into an agent's tools list, or testing it.

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

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

  • Changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/
  • Defining its FunctionBaseConfig schema
  • Registering it with @registerfunction
  • Wiring it into an agents tools list

Example prompts

  • “/deep-researcher-add-tool”

Requirements

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

Workflow steps

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

  1. Pick the closest existing package under sources/ and inspect its layout.
  2. Create sources// with src/register.py, a client module,
  3. Define a FunctionBaseConfig subclass with a stable name= (this becomes the
  4. Register an async @register_function that yields a FunctionInfo; yield a
  5. Add the [project.entry-points."nat.plugins"] entry and install the package
  6. Reference the tool in a config under configs/ (under functions:, then in
  7. Add focused tests; run the validation commands below.
  8. Summarize changed files and paste the test/lint evidence.

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:

    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use uv, 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 Add Tool loads about 1.1k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 70 tokens; SKILL.md has 475 words of instructions outside code blocks.

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

  • 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). 475 words, ~1,113 tokens.

Download SKILL.mdSave it as .claude/skills/deep-researcher-add-tool/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
deep-researcher-add-tool
description
Use when adding or changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/, defining its FunctionBaseConfig schema, registering it with @register_function, wiring it into an agent's tools list, or testing it.
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 nemo-agent-toolkit tool function sources

Add an Deep Researcher Agent Tool

Use this skill when a developer wants to add a general-purpose tool to Deep Researcher Agent — a NeMo Agent Toolkit (NAT) function such as a web search, calculator, or code helper. The tool is a package under sources/, registered with @register_function and referenced directly in an agent's tools list.

Start Here

  • Confirm this is a general utility tool. If it is domain-specific retrieval that should appear as a toggleable source in the UI, use deep-researcher-add-data-source instead — a data source is the same NAT function plus a data_source_registry entry. This skill stops at wiring the tool into an agent.
  • Read the authoritative files below before editing.
  • Copy the closest existing tool package rather than inventing a new shape.
  • Never print or commit API keys; resolve secrets at runtime via SecretStr.

Authoritative References

  • docs/source/extending/adding-a-tool.md: canonical 8-step walkthrough; the workflow below mirrors it.
  • sources/tavily_web_search/: minimal tool package.
  • sources/google_scholar_paper_search/: tool package with a separate client, a graceful missing-secret stub, and tests.
  • docs/source/extending/adding-a-data-source.md: "Data Source vs. Tool" — a data source is architecturally identical to a tool; only the registry wiring differs.

Existing tools to model on: tavily_web_search, exa_web_search, paper_search (Google Scholar), knowledge_retrieval.

Longer procedures live in this bundle:

Workflow

  1. Pick the closest existing package under sources/ and inspect its layout.
  2. Create sources/<my_tool>/ with src/register.py, a client module, pyproject.toml, and tests/.
  3. Define a FunctionBaseConfig subclass with a stable name= (this becomes the YAML _type); resolve any API key via SecretStr.
  4. Register an async @register_function that yields a FunctionInfo; yield a graceful stub when a required secret is missing.
  5. Add the [project.entry-points."nat.plugins"] entry and install the package editable.
  6. Reference the tool in a config under configs/ (under functions:, then in an agent's tools: list).
  7. Add focused tests; run the validation commands below.
  8. Summarize changed files and paste the test/lint evidence.
Show full SKILL.md (138 more words)Show less

Validation

Run the narrowest commands first; broaden only if the change touches shared code.

bash
uv pip install -e ./sources/my_tool
uv run pytest sources/my_tool/tests
uv run ruff check sources/my_tool
uv run ruff format --check sources/my_tool

Expected: the package installs, its tests pass, and Ruff reports no lint or format failures for the new tool package.

Common Mistakes

  • Omitting the [project.entry-points."nat.plugins"] entry in pyproject.toml, so NAT never discovers the registration at import time.
  • Crashing on a missing API key instead of yielding a stub that returns a clear error string.
  • Raising exceptions from the tool function; tools must return error messages as strings so they never crash the agent.
  • Weak docstrings: the LLM uses the function docstring as the tool description to decide when to call it — state what it does, when to use it, and what it returns.
  • Printing API keys or embedding secrets in YAML instead of using environment variables or SecretStr.
  • deep-researcher-configure-workflow
  • deep-researcher-add-data-source
  • deep-researcher-release-qa
  • deep-researcher-prepare-pr

© 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 2 other files (references) in .agents/skills/deep-researcher-add-tool of NVIDIA-AI-Blueprints/deep-researcher-agent.

  • SKILL.md
  • references/nat-function-pattern.md
  • references/testing.md

Open the folder on GitHubat commit 951a1a1

Compare with similar skills

Deep Researcher Add Tool 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 Add Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Researcher Add Tool this skillNVIDIA-AI-Blueprints/deep-researcher-agent886—~1.1kAutomated safety check: NotesApache-2.0
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT

Similar skills

  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Tavily Web Search

    allenpeng0705/EnvoyMesh

    Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

    3.1k GitHub starsUsed in 3 repos~2.5k tokens
    Productivity & AutomationAuto-check: notes

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 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
  • Deep Researcher Maintain CI

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when changing Deep Researcher Agent continuous integration, pre-commit, or contributor governance — editing .github/workflows/ (ci, ui, skills-eval, request-nvskills-ci)…

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

Questions about Deep Researcher Add Tool

What does Deep Researcher Add Tool do?

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…. Deep Researcher Add Tool is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent. Use when adding or changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/, defining its FunctionBaseConfig schema, registering it with @registerfunction, wiring it into an agent's tools list, or testing it.

When should I use Deep Researcher Add Tool?

Deep Researcher Add Tool fits situations like: changing a general-purpose Deep Researcher Agent tool (a NeMo Agent Toolkit function) under sources/; defining its FunctionBaseConfig schema; registering it with @registerfunction; wiring it into an agents tools list.

How do I install Deep Researcher Add Tool in Claude Code?

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

How do I install Deep Researcher Add Tool in Codex?

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

Can I use Deep Researcher Add Tool 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-add-tool -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-add-tool, .gemini/skills/deep-researcher-add-tool, .github/skills/deep-researcher-add-tool and .opencode/skills/deep-researcher-add-tool in your project.

What does Deep Researcher Add Tool need to run?

Going by SKILL.md and its folder, Deep Researcher Add Tool needs the command-line tools its instructions call (uv). Our summary lists: Python 3. 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 Add Tool access the network?

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

Is Deep Researcher Add Tool 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 Deep Researcher Add Tool use?

Deep Researcher Add Tool 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 Add Tool use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Deep Researcher Add Tool?

Skills that share tags, products or a category with Deep Researcher Add Tool: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars) and Nature Paper Card (Yuan1z0825/nature-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Researcher Add Tool?

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.