nemo-gym-debugging

nemo-gym-debugging is a skill for Claude Code, Codex from NVIDIA-NeMo/Gym. It costs 68 tokens per session (785 once invoked), scanned A, original, Apache-2.0.

A troubleshooting guide for NeMo Gym, a system for running model-training and evaluation jobs. It groups failures by areas such as servers, configuration, data, verification, caching, and performance.

In plain words
What is it for?
Use it to diagnose missing or incomplete JSONL results, schema and verifier errors, Slurm or Ray failures, vLLM readiness problems, tool and sandbox issues, stale inputs, cache problems, and slow jobs.
Why use it?
It helps you investigate failed or suspicious runs in a consistent order instead of guessing which component is broken.

Skill for Claude CodeCodex

About the project

NVIDIA-NeMo/Gym is a library and infrastructure for evaluating and improving models and agents inside environments, where each environment defines tasks, agent interaction, verification, and execution state. It is for teams running reproducible evaluations or training at scale across settings such as code execution, tool calling, and sandboxes, and the catalogue entries provide skills and instructions for working with it.

NVIDIA-NeMo/Gym · 1,164 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nvidia-nemo/gym/nemo-gym-debugging
Any agent
npx skills add NVIDIA-NeMo/Gym --skill nemo-gym-debugging
Clone the repo
git clone --depth 1 https://github.com/NVIDIA-NeMo/Gym

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nemo-gym-debugging

README.md
[![agentmods](https://agentmods.dev/badge/skills/nvidia-nemo/gym/nemo-gym-debugging.svg)](https://agentmods.dev/skills/nvidia-nemo/gym/nemo-gym-debugging)
Your own site
<a href="https://agentmods.dev/skills/nvidia-nemo/gym/nemo-gym-debugging"><img src="https://agentmods.dev/badge/skills/nvidia-nemo/gym/nemo-gym-debugging.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 785 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00068 $0.00785
Opus 5 $0.00034 $0.00392
Sonnet 5 $0.00014 $0.00157
Haiku 4.5 $0.00007 $0.00078

Measured 5d ago against content hash 1f005e915095, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

nemo-gym-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/check_tool_call_jsonl.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/nemo-gym-debugging/SKILL.md · 62 lines

How it starts

The opening of the file, as written. The whole thing — 62 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Nemo Gym Debugging

Invocation Check

Use this skill when something failed or looks suspicious in a Nemo Gym run. If the task is adding a new env, use the nemo-gym-env-integration skill; if it is changing profiling behavior, use the nemo-gym-reward-profiling skill.

Debug by classification, not by guessing. The first goal is to decide whether the issue is:

  • infra: Slurm, Ray, container, filesystem, network, ports
  • model serving: vLLM startup/readiness/throughput
  • config: wrong config bundle, missing agent, wrong extra args
  • data/schema: JSONL fields do not match verifier/resource server expectations
  • verifier/runtime: resource server exception or malformed verify response
  • cache/resume: stale materialized inputs or partial rollout output
  • throughput/resources: concurrency too high, judge bottleneck, tool/sandbox latency

Debug Order

  1. Check Slurm/Ray job state and logs.
  2. Check vLLM readiness and /models availability.
  3. Check Gym server readiness: all expected servers started.
  4. Check tool routing if the env uses tools; check sandbox readiness only if a sandbox is configured.
  5. Check materialized inputs and source data timestamps.
  6. Check rollout output and profiling/metrics output counts.
  7. Inspect the first real verifier exception, not shutdown noise.
  8. Compare failing row schema against the resource server request model.

High-Value Suspects

  • If data changed and resume_from_cache was enabled, stale materialized inputs are a first-class suspect.
  • If rollout output has a few rows and profiling is empty, inspect verifier errors and partial-output cache.
  • If all servers are ready but verifier returns 422/500, inspect request body schema before debugging infra.
  • If tool envs hang or partially work, check tool ownership/loading before changing model settings; check sandbox readiness only when a sandbox is actually part of the env.
  • If tool-call rows fail before generation with vLLM grammar/schema errors, read references/vllm-tool-call-schema-checks.md and run a static tool-schema check before changing Gym wrappers.
  • If logs only show nested "inner server" 500s without the real provider/verifier body, first enable existing request-boundary visibility with ++global_aiohttp_client_request_debug=True. Read references/request-boundary-visibility.md before changing code.

Read the full file on GitHub · 62 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 62 lines · 68 tokens per session scan A 1f005e915095

Subscribe to this mod's changes

nemo-gym-debugging is a skill published in the GitHub repository NVIDIA-NeMo/Gym (1,164 stars, last pushed today), licensed Apache-2.0. It adds 68 tokens to every session and 785 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

writing-bench-task-judge

Use when writing or modifying checkgoals() / getanswer() / App check methods in benchenv/task/, or when reviewing a draft task's judge correctness. Triggers include adding a new task, editing a judge method, or diagnosing a judge false-positive/negative.

Purewhiter/mobilegym · 68 tokens

testing-bench-task

Use when adding or modifying offline judge tests for benchenv tasks — specifically entries in OFFLINEJUDGEPOSITIVECASES / OFFLINEJUDGENEGATIVECASES in benchenv/tests/ /testtasks.py, or writing live tests. Triggers after a new task is added, or when tightening judge coverage.

Purewhiter/mobilegym · 74 tokens

designing-bench-task

Use when designing a new benchenv task suite, adding several new tasks to an existing suite, or critiquing a task-set proposal for a mobile-gym App — before any class FooTask(...) is written under benchenv/task/.

Purewhiter/mobilegym · 57 tokens

model_finetuning

Fine-tune LLMs using reinforcement learning with TRL - SFT for instruction tuning, DPO for preference alignment, PPO/GRPO for reward optimization, and reward model training. Use when need RLHF, align model with preferences, or train from human feedback. Works with HuggingFace Transformers.

vuralserhat86/antigravity-agentic-skills · 67 tokens

model_finetuning

Fine-tune LLMs using reinforcement learning with TRL - SFT for instruction tuning, DPO for preference alignment, PPO/GRPO for reward optimization, and reward model training. Use when need RLHF, align model with preferences, or train from human feedback. Works with HuggingFace Transformers.

DonggangChen/antigravity-agentic-skills · 67 tokens

foundry-config-setup

Resolve missing setup caused by a hardcoded Foundry project endpoint or model in a sample. Use when a sample fails because it uses a placeholder/hardcoded projectendpoint (for example "https://your-project.services.ai.azure.com") or a hardcoded model instead of reading them from the environment.

microsoft/agent-framework · 65 tokens