Linting and Formatting

SkillDev tools

Lets your agent run linters and formatters like ruff, black, and mypy to fix code style issues in Megatron-LM.

Then ask your AI: use the Linting and Formatting skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.

No other account needed.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

Linting and formatting for Megatron-LM. Covers running autoformat.sh, tools (ruff, black, isort, pylint, mypy), and code style rules.

What this skill tells your AI

The instructions your AI receives, as published by nvidia/skills in skills/mcore-linting-and-formatting/SKILL.md and read by Ahel’s review.

Running the Formatter

Run before opening a PR:

# Check mode (no changes applied)
BASE_REF=main CHECK_ONLY=true SKIP_DOCS=false bash tools/autoformat.sh

# Fix mode
BASE_REF=main CHECK_ONLY=false bash tools/autoformat.sh

Tools invoked: black, isort, pylint, ruff, mypy.

Import Ordering

After editing imports in any Python files, always run uv run isort on those files before committing:

uv run isort <file1>.py <file2>.py

Setting Up the Linting Group

Inside the container:

uv sync --locked --only-group linting

This installs ruff, black, isort, pylint — the same tools used by tools/autoformat.sh and CI's linting job.

Code Style Rules

Type hints: required on all public API functions. Use X | None, not Optional[X].
Docstrings: Google-style on all public classes and functions.
Naming: follow Python conventions — snake_case for functions and variables, PascalCase for classes.
Line length: 119 characters (configured in pyproject.toml).
No bare except: always catch specific exception types.

Signals

GitHub stars: 4k
Forks: 434
Last commit: Oct 2026

Advanced

Item type: skill
Key: mcore-linting-and-formatting
Source: github.com/nvidia/skills

github.com/nvidia/skills