Skip to main content
skill CX Codex

nemo-rl-docs — Claude Code skill: NeMo-RL docs conventions

This skill hands your agent the documentation rules for NeMo-RL: keeping docs/index.md current and writing docstrings in Google style. Useful when you touch the docs.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-code
Open on GitHub

What nemo-rl-docs does

The skill spells out how documentation works in the NeMo-RL project. Add a new markdown file under docs/**/*.md or rename one, and the agent updates docs/index.md, placing the document in the section that fits best. Classes and functions get Google style docstrings, which Sphinx can parse.

Comments follow a separate rule. If an interface may be used outside its file, prefer a docstring; comments stay for code inside a function or for interfaces local to a file. When a new feature lands, the agent documents it in whichever file under docs/ matches closest, and creates a new doc plus an docs/index.md entry if nothing fits.

The scope is narrow on purpose. Bug fixes and CI changes need no documentation at all, and the skill stays away from test fixes, dependency bumps, refactoring and performance tuning. That matters if you wire it into a repo-wide workflow: it will keep pulling doc edits into changes that never asked for them.

What it helps with

  • add a new markdown file under docs/ and register it in docs/index.md
  • rename a doc and fix its place in the index
  • convert class and function docstrings to Google style
  • decide between a docstring and an inline comment
  • pick the right file in docs/ for a new feature

Example prompts for the agent

  • add docs for the new module under docs/ and update docs/index.md
  • rename docs/training.md and fix the index entry
  • check the docstrings in this file — are they Google style?

How to install nemo-rl-docs

1Skills CLI (Vercel)

npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-code

2Manually: put the files in place

~/.claude/skills/nemo-rl-docs/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/nemo-rl-docs/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about nemo-rl-docs

How do I install nemo-rl-docs in Claude?

Run npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-code. The skill lands at ~/.claude/skills/nemo-rl-docs/SKILL.md.

What does nemo-rl-docs do?

It gives the agent NeMo-RL documentation conventions: keeping docs/index.md up to date, using Google style docstrings, and choosing where a new feature doc belongs.

Which tasks is this skill not meant for?

Bug fixes, test fixes, dependency bumps, refactoring, CI/CD changes and performance tuning. Bug fixes and CI changes need no documentation updates at all.

Source text

SKILL.md · Apache-2.0
---
name: nemo-rl-docs
license: Apache-2.0
description: "Documentation conventions for NeMo-RL. Covers docs/index.md updates and docstring format. Do NOT use for: bug fixes, test fixes, dependency bumps, refactoring, CI/CD changes, performance tuning, or any task that does not involve writing or updating documentation."
when_to_use: Adding or updating documentation; adding a new markdown file; reviewing docstrings; 'docs/index.md', 'docstring format', 'Sphinx', 'where do I add docs', during code review.
---

# Documentation Conventions

## Keep docs/index.md Up to Date

When a new markdown doc is added under `docs/**/*.md` or a markdown file is renamed, ensure that @docs/index.md is updated and the document appears in the most appropriate section.

## Docstring Format

Use [Google style](https://google.github.io/styleguide/pyguide.html) docstrings for classes and functions. These are parseable by Sphinx.

For interfaces that may be used outside a file, prefer docstrings over comments. Comments should be reserved for code within a function or interfaces local to a file.

## Document New Features

When a new feature is added, update or create documentation in the `docs/` directory that most closely matches the feature. Look at existing docs to find the best fit — if none exists, create a new doc and add it to @docs/index.md.

Documentation changes are **not required** for bug fixes or CI-related changes.

© NVIDIA · Apache-2.0 · NVIDIA/skills

Similar skills

Everything for Writing and docs →

From the same set178

mcore-linting-and-formatting Sets up linting and code formatting for Megatron-LM projects. It helps fix ruff and mypy violations and sort imports before opening a pull request. CX Codex +1 1,800installs nemo-mbridge-perf-tp-dp-comm-overlap A skill that walks through enabling TP, DP and PP communication overlap in Megatron-Bridge: which knobs to turn, where the code gates it, how to verify. CX Codex +1 1,800installs nemo-mbridge-perf-moe-dispatcher-selection Picks between alltoall, DeepEP and HybridEP for MoE token dispatch based on your hardware, EP degree and optimization stage. CX Codex +1 1,800installs nemo-mbridge-perf-megatron-fsdp Configures Megatron FSDP in Megatron-Bridge to replace standard DDP, helping resolve out-of-memory errors and verify training checkpoints. CX Codex +1 1,800installs nemo-mbridge-resiliency A skill covering resiliency setup in Megatron Bridge: fault tolerance, straggler detection, preemption and re-run state machine. CX Codex +1 1,800installs nemo-mbridge-perf-hierarchical-context-parallel Configures hierarchical context parallelism in Megatron-Bridge. Useful for scaling long-sequence model training when context length exceeds KV head counts. CX Codex +1 1,800installs nemo-mbridge-perf-moe-hardware-configs A reference of MoE training starting configurations for H100, B200, GB200, and GB300. Use it when selecting a dispatcher, parallelism layout, or planning throughput checks. CX Codex +1 1,800installs nemo-mbridge-perf-moe-comm-overlap A skill for MoE expert-parallel communication overlap in Megatron Bridge: dispatch/combine, flex dispatcher backends, expert wgrad scheduling. CX Codex +1 1,800installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor