Agent skill

Deep Researcher Configure Workflow

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

Apache-2.0Auto-check: notesDevOps & Cloud

Install Deep Researcher Configure Workflow

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

At a glance

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…

  • Works in 3 steps: Scaffold — cp configs/.yml… → Compose — references/composing-config.md → Validate (required) —
  • Validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile
  • SKILL.md covers Start Here, Authoritative References, Workflow and Validation, plus 2 more sections
  • Runs Python scripts from its folder; calls uv

What it does

Deep Researcher Configure Workflow is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent. Use when composing, adapting, or validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile, enabling tools and datasourceregistry sources, wiring chat or direct data-science workflows, configuring NeMo Relay and general.telemetry observability plus general.frontend deepresearcherapi settings, and pre-flighting cross-references before deploy or serve. Hand off deploy to deep-researcher-deploy, live research to deep-researcher-research, prompt/model edits to…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts, reference files and assets (for example `assets/config-scaffold.yml`, `references/composing-config.md` and `references/config-profiles.md`). Compatibility notes: Claude Code, Codex, Cursor, OpenCode, and Agent Skills-compatible tools.

It sits in DevOps & Cloud, covering Observability and CI/CD. 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

  • Validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile
  • Enabling tools and datasourceregistry sources
  • Direct data-science workflows
  • Configuring NeMo Relay and general.telemetry observability plus general.frontend deepresearcherapi settings

Example prompts

  • “/deep-researcher-configure-workflow”

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

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

  1. Scaffold — cp configs/.yml configs/config_.yml (or
  2. Compose — references/composing-config.md
  3. Validate (required) —

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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 Configure Workflow loads about 1.1k tokens when it runs, and up to ~5.2k if it reads all its reference files. Until then it costs about 166 tokens; SKILL.md has 234 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~166
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
~5.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.

  • NoteMentions a .env fileSKILL.md:61
    dotenv -f deploy/.env run nat serve --config_file configs/config_<name>.yml --port 8000
  • 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); the scripts in this folder 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). 234 words, ~1,104 tokens.

Download SKILL.mdSave it as .claude/skills/deep-researcher-configure-workflow/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
deep-researcher-configure-workflow
description
Use when composing, adapting, or validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile, enabling tools and data_source_registry sources, wiring chat or direct data-science workflows, configuring NeMo Relay and general.telemetry observability plus general.front_end deep_researcher_api settings, and pre-flighting cross-references before deploy or serve. Hand off deploy to deep-researcher-deploy, live research to deep-researcher-research, prompt/model edits to deep-researcher-customize-prompts-models, and new source code to deep-researcher-add-tool or deep-researcher-add-data-source.
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 config yaml workflow data-source-registry telemetry deep_researcher_api

Configure Deep Researcher Agent Workflows

Use this skill when a developer or operator needs a new configs/config_*.yml file.

Start Here

  • Confirm this is config composition — not deploy (deep-researcher-deploy), live research (deep-researcher-research), prompt edits (deep-researcher-customize-prompts-models), or new NAT packages (deep-researcher-add-tool / deep-researcher-add-data-source).
  • Copy the closest shipped configs/*.yml profile; merge feature blocks from others.
  • Every produced config must pass validate_config.py before hand-off.

Authoritative References

  • docs/source/customization/configuration-reference.md — all fields and defaults
  • docs/source/customization/tools-and-sources.md
  • docs/source/deployment/observability.md — tracing setup detail
  • frontends/deep_researcher_api/README.md
  • configs/config_web_default_llamaindex.yml / configs/config_cli_default.yml

Bundle:

Workflow

  1. Scaffold — cp configs/<profile>.yml configs/config_<name>.yml (or assets/config-scaffold.yml + merge blocks).
  2. Compose — references/composing-config.md: adjust registry, tools, agents, LLMs, telemetry, deep_researcher_api, workflow flags. Use config_web_default_llamaindex.yml as the live default for web general: blocks; configuration-reference.md for every option. Use references/env-vars.md for feature-specific env vars.
  3. Validate (required) —
bash
uv run python .agents/skills/deep-researcher-configure-workflow/scripts/validate_config.py configs/config_<name>.yml

Fix every ERROR:; re-run until exit code 0. Then hand off to deep-researcher-deploy or:

bash
dotenv -f deploy/.env run nat serve --config_file configs/config_<name>.yml --port 8000

Validation

bash
uv run python .agents/skills/deep-researcher-configure-workflow/scripts/validate_config.py <config.yml>

See references/config-schema.md. Expected: exit 0.

Common Mistakes

  • Skipping validate_config.py on a new config.
  • Undefined llms: alias or registry tool not declared under functions:.
  • Missing functions required by the selected workflow: the chat workflow needs intent_classifier, shallow_research_agent, and deep_research_agent; the direct DS workflow needs data_science_agent.
  • use_async_deep_research: true without general.front_end (deep_researcher_api).
  • Inventing feature YAML — copy from a shipped profile.
  • deep-researcher-deploy
  • deep-researcher-research
  • deep-researcher-customize-prompts-models
  • deep-researcher-add-tool
  • 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 6 other files (scripts, references, assets) in .agents/skills/deep-researcher-configure-workflow of NVIDIA-AI-Blueprints/deep-researcher-agent.

  • SKILL.md
  • assets/config-scaffold.yml
  • references/composing-config.md
  • references/config-profiles.md
  • references/config-schema.md
  • references/env-vars.md
  • scripts/validate_config.py

Open the folder on GitHubat commit 951a1a1

Compare with similar skills

Deep Researcher Configure Workflow 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 Configure Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Researcher Configure Workflow this skillNVIDIA-AI-Blueprints/deep-researcher-agent886—~1.1kAutomated safety check: NotesApache-2.0
Plugin Testapache/skywalking-python219—~2.3kAutomated safety check: PassApache-2.0
Devops InfrastructureCloudAI-X/claude-workflow-v21.4k—~2.7kAutomated safety check: NotesMIT
Dotnet Devopsnovotnyllc/dotnet-artisan232—~1.1kAutomated safety check: PassMIT
Cloud Devopsdavila7/claude-code-templates33k4 repos~1.4kAutomated safety check: PassMIT
Ship Gatealirezarezvani/claude-skills28k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Plugin Test

    apache/skywalking-python

    Build Docker test images and run SkyWalking Python plugin/unit/e2e tests locally, mirroring the CI pipeline

    219 GitHub stars~2.3k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Devops Infrastructure

    CloudAI-X/claude-workflow-v2

    Guides Docker, CI/CD pipelines, deployment strategies, infrastructure as code, and observability setup.

    1.4k GitHub stars~2.7k tokensUpdated 4 days ago
    DevOps & CloudAuto-check: notes
  • Dotnet Devops

    novotnyllc/dotnet-artisan

    Configures .NET CI/CD pipelines (GitHub Actions with setup-dotnet, NuGet cache, reusable workflows; Azure DevOps with DotNetCoreCLI, templates, multi-stage), containerization (multi-stage…

    232 GitHub stars~1.1k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Cloud Devops

    davila7/claude-code-templates

    Cloud infrastructure and DevOps workflow covering AWS, Azure, GCP, Kubernetes, Terraform, CI/CD, monitoring, and cloud-native development.

    33k GitHub starsUsed in 4 repos~1.4k tokens
    DevOps & CloudAuto-check passed
  • Ship Gate

    alirezarezvani/claude-skills

    Pre-production audit that scans a codebase for security, database, deployment, code quality, AI/LLM, dependency, frontend, and observability issues.

    28k GitHub stars~1.7k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Sap Btp Developer Guide

    secondsky/sap-skills

    Develops business applications on SAP Business Technology Platform (BTP) using CAP (Node.js/Java) or ABAP Cloud.

    462 GitHub stars~4.4k tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed

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

All 15 skills in this repo
  • 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
  • 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

Categories

Questions about Deep Researcher Configure Workflow

What does Deep Researcher Configure Workflow do?

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…. Deep Researcher Configure Workflow is an agent skill from NVIDIA-AI-Blueprints/deep-researcher-agent.frontend deepresearcherapi settings, and pre-flighting cross-references before deploy or serve.

When should I use Deep Researcher Configure Workflow?

Deep Researcher Configure Workflow fits situations like: validating an Deep Researcher Agent workflow YAML under configs/ — selecting a shipped profile; enabling tools and datasourceregistry sources; direct data-science workflows; configuring NeMo Relay and general.telemetry observability plus general.frontend deepresearcherapi settings.

How do I install Deep Researcher Configure Workflow in Claude Code?

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

How do I install Deep Researcher Configure Workflow in Codex?

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

Can I use Deep Researcher Configure Workflow 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-configure-workflow -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-configure-workflow, .gemini/skills/deep-researcher-configure-workflow, .github/skills/deep-researcher-configure-workflow and .opencode/skills/deep-researcher-configure-workflow in your project.

What does Deep Researcher Configure Workflow need to run?

Going by SKILL.md and its folder, Deep Researcher Configure Workflow needs Python for the scripts in its folder and 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 Configure Workflow 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 Configure Workflow 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Deep Researcher Configure Workflow use?

Deep Researcher Configure Workflow 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 Configure Workflow use?

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

What are the alternatives to Deep Researcher Configure Workflow?

Skills that share tags, products or a category with Deep Researcher Configure Workflow: Plugin Test (apache/skywalking-python, 219 stars), Devops Infrastructure (CloudAI-X/claude-workflow-v2, 1.4k stars), Dotnet Devops (novotnyllc/dotnet-artisan, 232 stars) and Cloud Devops (davila7/claude-code-templates, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Researcher Configure Workflow?

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.