nemo-rl-docs — скилл для Claude Code: правила документации NeMo-RL
Скилл задаёт агенту правила оформления документации NeMo-RL: обновление docs/index.md и стиль докстрингов. Пригодится, когда вы пишете или правите доки.
npx skills add NVIDIA/skills --skill nemo-rl-docs -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/nemo-rl-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nemo-rl-docs/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-rl-docs -a codex2Вручную: положить файлы
.agents/skills/nemo-rl-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-rl-docs -a cursor2Вручную: положить файлы
.cursor/skills/nemo-rl-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install NVIDIA/skills nemo-rl-docs2Вручную: положить файлы
.github/skills/nemo-rl-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-rl-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/NVIDIA/skills --path skills/nemo-rl-docsВручную: положить файлы
.devin/skills/nemo-rl-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-rl-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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