К основному содержанию
скилл CX Codex

nemo-rl-docs — скилл для Claude Code: правила документации NeMo-RL

Скилл задаёт агенту правила оформления документации NeMo-RL: обновление docs/index.md и стиль докстрингов. Пригодится, когда вы пишете или правите доки.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-code
Открыть на GitHub

Что делает nemo-rl-docs

Скилл описывает, как в проекте NeMo-RL ведётся документация. Когда под docs/**/*.md появляется новый markdown-файл или существующий переименовывают, агент должен обновить docs/index.md и поставить документ в подходящий раздел. Для классов и функций предписан Google style докстрингов — Sphinx их разбирает.

Есть и правило про комментарии: если интерфейс может использоваться за пределами файла, лучше докстринг, а комментарии оставляют для кода внутри функции или локальных интерфейсов. Новую фичу агент документирует в том файле каталога docs/, который ближе всего по смыслу; если подходящего нет — создаёт новый и добавляет его в docs/index.md.

Границы прописаны жёстко: для багфиксов и изменений CI документация не требуется. Скилл не берётся за исправление тестов, обновление зависимостей, рефакторинг и тюнинг производительности. Это повод не звать его на каждую правку в репозитории — иначе он будет тянуть за собой лишние изменения в доках.

Какие задачи решает

  • добавить новый markdown-файл в docs/ и не забыть про docs/index.md
  • переименовать документ и поправить ссылки в оглавлении
  • привести докстринги классов и функций к Google style
  • решить, писать докстринг или обычный комментарий
  • найти подходящий файл в docs/ под новую фичу

Примеры запросов агенту

  • добавь доку на новый модуль в docs/ и обнови docs/index.md
  • переименуй docs/training.md и поправь оглавление
  • проверь докстринги в этом файле — они в Google style?

Как установить nemo-rl-docs

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/nemo-rl-docs/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nemo-rl-docs

Как установить nemo-rl-docs в Claude?

Выполните npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-code. Скилл встанет в ~/.claude/skills/nemo-rl-docs/SKILL.md.

Что делает nemo-rl-docs?

Задаёт агенту правила документации NeMo-RL: следит за актуальностью docs/index.md, требует Google style докстрингов и подсказывает, куда положить доку под новую фичу.

Для каких задач скилл не подходит?

Для багфиксов, правки тестов, обновления зависимостей, рефакторинга, изменений CI/CD и тюнинга производительности. Для багфиксов и CI-правок документация вообще не требуется.

Исходный текст

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

Похожие скиллы

Всё по теме «Тексты и документация» →
docs-guard amElnagdy Проверяет документацию, README и докстринги на соответствие коду проекта. Находит выдуманные сигнатуры и удаляет пустые формулировки. CX Codex +1 4 000установок code-documenter https://github.com/Jeffallan Создаёт и проверяет документацию к коду, API и руководства. Нужен при добавлении docstring, JSDoc или спецификации OpenAPI. CX Codex +1 5 700установок code-documentation aj-geddes Скилл для написания документации прямо в коде: JSDoc, Python-докстринги, JavaDoc, комментарии и описания API. Пригодится, когда нужно задокументировать функции и классы, а не переписывать их вслепую. CX Codex +1 492установок nemo-guardrails Orchestra Research Скилл помогает настраивать runtime-защиту LLM-приложений: от проверки jailbreak до фильтрации PII. Пригодится для правил на Colang 2.0. CX Codex +1 944установок nemo-evaluator-sdk Orchestra Research Скилл запускает оценку языковых моделей на 100+ бенчмарках из 18+ харнессов: MMLU, HumanEval, GSM8K, safety и VLM. Пригодится, когда нужно сравнить модели воспроизводимо. CX Codex +1 943установок openai-docs официальный openai Скилл ищет актуальные материалы OpenAI и помогает отвечать по API, Codex, моделям и обновлению промптов с опорой на официальную документацию. CX Codex +1 6 100установок

Из того же набора178

mcore-linting-and-formatting Скилл настраивает проверку и форматирование кода в проекте Megatron-LM. Помогает исправить ошибки ruff, mypy и отсортировать импорты перед открытием PR. CX Codex +1 1 800установок nemo-mbridge-perf-tp-dp-comm-overlap Скилл ведёт по настройке перекрытия коммуникаций TP, DP и PP в Megatron-Bridge: какие ручки крутить, где смотреть код и как проверить результат. CX Codex +1 1 800установок nemo-mbridge-perf-moe-dispatcher-selection Помогает выбрать между alltoall, DeepEP и HybridEP для раздачи токенов в MoE-моделях по железу, размеру EP и этапу оптимизации. CX Codex +1 1 800установок nemo-mbridge-perf-megatron-fsdp Скилл помогает настроить Megatron FSDP в Megatron-Bridge для распределённого обучения вместо стандартного DDP, избежать падений по OOM и проверить чекпоинты. CX Codex +1 1 800установок nemo-mbridge-resiliency Скилл описывает настройку отказоустойчивости в Megatron Bridge: перезапуски, детекцию отстающих рангов, преемпцию и повторные прогоны. CX Codex +1 1 800установок nemo-mbridge-perf-hierarchical-context-parallel Скилл настраивает иерархический контекстный параллелизм в Megatron-Bridge. Помогает масштабировать обучение длинных последовательностей при нехватке KV-голов. CX Codex +1 1 800установок nemo-mbridge-perf-moe-hardware-configs Справочник стартовых конфигураций обучения MoE для H100, B200, GB200 и GB300. Нужен для выбора диспетчера, параллелизма и проверки ожидаемой производительности. CX Codex +1 1 800установок nemo-mbridge-perf-moe-comm-overlap Скилл по перекрытию expert-parallel коммуникаций в Megatron Bridge: настройка dispatch/combine, flex-диспетчер и планирование expert wgrad. CX Codex +1 1 800установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой