---
title: "Agent Skills"
description: "Vetted workflows for AI coding assistants bundled with NeMo Gym."
position: 5
---

NeMo Gym ships **agent skills** — curated instruction files that teach AI coding assistants how to work effectively in this repository. They encode endorsed workflows for common tasks like adding benchmarks, debugging rollouts, and maintaining the docs site, so agents can follow project conventions without guesswork.

Skills are versioned with the repo and kept up to date as Gym evolves. Gym will continue to add skills as new workflows stabilize.

## Where Skills Live

| Directory | Assistants |
|---|---|
| [`.claude/skills/`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills) | Claude Code and other tools that read the Claude skills layout |
| [`.codex/skills/`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.codex/skills) | OpenAI Codex |

The `.claude/skills/` tree is the superset — it includes Gym-specific skills plus vendored skills such as [`gh-stack`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/gh-stack) for stacked pull requests.

<Info>
Assistants discover skills automatically when they are pointed at a local Gym checkout. No extra install step is required beyond cloning the repository.
</Info>

## Available Skills

| Skill | What it covers |
|---|---|
| [`add-benchmark`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/add-benchmark) | End-to-end workflow for adding a new benchmark or training environment |
| [`nemo-gym-reward-profiling`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-reward-profiling) | `gym env start`, `gym eval run`, and `gym eval profile` baselining |
| [`nemo-gym-debugging`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-debugging) | Diagnosing failed rollouts, partial JSONL, verifier errors, and infra issues |
| [`nemo-gym-docs`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-docs) | Adding, moving, and removing pages on the Fern docs site |
| [`nemo-gym-blade-analysis`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-blade-analysis) | BLADE-style benchmark reports from rollout evidence |
| [`nemo-gym-pivot-datasets`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-pivot-datasets) | Creating and validating pivot datasets from rollout artifacts |
| [`gh-stack`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/gh-stack) | Stacked pull request workflows with the `gh-stack` CLI extension |

The Codex tree currently includes the five `nemo-gym-*` operational skills (excluding `add-benchmark`, `nemo-gym-docs`, and `gh-stack`).

## Using Skills

When you work with an AI coding assistant in a Gym checkout, mention the task in natural language — for example, "add a new benchmark" or "debug this rollout failure." Assistants that support skills will match your request against the skill descriptions and follow the bundled workflow.

You can also point an assistant at a specific skill file if you want a particular playbook:

```text
Follow .claude/skills/add-benchmark/SKILL.md to integrate this benchmark.
```

<Tip>
The [`nemo-gym-docs`](https://github.com/NVIDIA-NeMo/Gym/tree/main/.claude/skills/nemo-gym-docs) skill mirrors the procedures in the [Fern docs README](https://github.com/NVIDIA-NeMo/Gym/blob/main/fern/README.md) — use it when contributing documentation changes.
</Tip>

---

## Related Topics

- [Development Setup](/contribute/development-setup) — environment setup, CI, and commit requirements
- [Add a Benchmark](https://docs.nvidia.com/nemo/gym/contribute/environments/adding-a-benchmark) — human-readable tutorial that complements the `add-benchmark` skill
- [Contribute Environments](/contribute/environments) — guidance for new training environments
