Skip to content

Add focused NeMo Retriever agent skills#2081

Draft
jeremyjordan wants to merge 3 commits into
NVIDIA:mainfrom
jeremyjordan:jeremyj/skills-exploration
Draft

Add focused NeMo Retriever agent skills#2081
jeremyjordan wants to merge 3 commits into
NVIDIA:mainfrom
jeremyjordan:jeremyj/skills-exploration

Conversation

@jeremyjordan
Copy link
Copy Markdown

@jeremyjordan jeremyjordan commented May 21, 2026

Description

This PR adds a focused NeMo Retriever agent-skills bundle produced through agent-driven exploration of the repository and validation against the current CLI surface. The skills are scoped to supported or practically usable Retriever workflows, packaged under nemo_retriever/.agents/skills, exposed through per-skill symlinks in .agents/skills and .claude/skills (so they can coexist with other contributor-focused root skills), and included in the wheel package data.

The PR also keeps the CLI guidance honest for agents by labeling top-level subcommands that are experimental and not product-supported in retriever --help and the corresponding subcommand help pages.

Skills Added

  • nemo-retriever-setup: installation, environment verification, extras, model/API prerequisites, and first CLI checks.
  • nemo-retriever-ingest: one-shot ingest, pipeline ingest, LanceDB table creation, embedding configuration, and ingest validation.
  • nemo-retriever-query: querying existing LanceDB indexes, matching ingest settings, reranking behavior, hit-schema inspection, and evidence-grounded answer synthesis.
  • nemo-retriever-service: local service startup, service ingest client usage, HTTP endpoint troubleshooting, config handling, and Helm/service deployment orientation.

Other Changes

  • Replaces the previous single root .agents symlink with per-skill symlinks in .agents/skills/ and .claude/skills/.
  • Removes the older monolithic .claude/skills/nemo-retriever skill.
  • Adds CLI/test fixes discovered while exercising the skills against real commands, including local HuggingFace query flags and split-skill prompt handling. I'm including the changes in this PR because the skills depend on them, but they should likely be separated out into a different focused MR before merging.
  • Adds root CLI help labels for experimental, not product-supported command groups.

Checklist

  • I am familiar with the Contributing Guidelines.
  • New or existing tests cover these changes.
  • The documentation is up to date with these changes.
  • If adjusting docker-compose.yaml environment variables have you ensured those are mimicked in the Helm values.yaml file.

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 21, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Signed-off-by: Jeremy Jordan <jeremyj@nvidia.com>
…odebase and development of skills

Signed-off-by: Jeremy Jordan <jeremyj@nvidia.com>
@jeremyjordan jeremyjordan force-pushed the jeremyj/skills-exploration branch from 08afbae to 5c840d5 Compare May 27, 2026 13:44
Signed-off-by: Jeremy Jordan <jeremyj@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant