SKILL.md
Verify the current change proportionally to its risk. Do not report success for checks that were not run.
- Establish the complete scope. Inspect committed, staged, unstaged, and untracked changes:
``bash git status --short git diff --name-only origin/main...HEAD git diff --name-only git diff --cached --name-only ``
Replace origin/main if the PR targets another branch. Read the full diff and any applicable nested AGENTS.md or CLAUDE.md files.
- Review tests and documentation. Before running commands, determine whether the change is adequately covered:
- Require a regression test for a bug fix and focused unit tests for new or changed behavior, including important edge cases. If no test is appropriate, require a concrete explanation. - Check whether changes to public APIs, configuration, CLI behavior, examples, or user workflows are reflected in the relevant documentation. If no documentation update is needed, record why.
- Run repository checks. For staged changes, run:
``bash pre-commit run ``
For committed branch changes, run pre-commit run --from-ref origin/main --to-ref HEAD. If pre-commit is unavailable, use uvx pre-commit for the same command. Review and stage hook fixes, then rerun until clean. Also run git diff --check.
- Run the smallest relevant tests. Prefer focused test files or test names while iterating, then expand to the affected collection when practical:
- nemo/collections/asr/ → uv run pytest tests/collections/asr -m "not pleasefixme" - nemo/collections/tts/ → uv run pytest tests/collections/tts -m "not pleasefixme" - nemo/collections/audio/ → uv run pytest tests/collections/audio -m "not pleasefixme" - nemo/collections/speechlm2/ → uv run pytest tests/collections/speechlm2 -m "not pleasefixme" - nemo/collections/common/ → uv run pytest tests/collections/common -m "not pleasefixme" - nemo/core/ → uv run pytest tests/core -m "not pleasefixme"
Add --with_downloads only for tests marked as requiring model downloads. Use --cpu when supported and a GPU is unavailable. If documentation changed, install its dependencies with uv sync --locked --group docs and build it with uv run make -C docs html.
- Verify commit sign-offs. Every commit in the PR must have a DCO
Signed-off-bytrailer:
``bash git log --format='%h %s%n%(trailers:key=Signed-off-by)' origin/main..HEAD ``
Create commits with git commit -s. Add a missing trailer to your own latest commit with git commit --amend --no-edit -s; do not rewrite other contributors' commits without authorization.
- Report results. Summarize the reviewed diff, test-coverage and documentation conclusions, exact commands and outcomes, commit sign-off status, and any skipped checks with reasons. For failures, include the relevant error and a concrete next step.