＋ Add to collection

Install (CLI)

npx skillmds add nvidia/mcore-linting-and-formatting

Or Copy and Paste in Your Agent chat

Please install the Agent Skill "nvidia/mcore-linting-and-formatting" for me from skillmd.com. A SkillMD skill is a SKILL.md file — plain markdown plus a few companion files — that you save into my skills directory. Use whichever fetch route fits your setup: (1) if you have a terminal, run npx -y skillmds add nvidia/mcore-linting-and-formatting; (2) otherwise fetch the file manifest at https://api.skillmd.com/api/skills/nvidia/mcore-linting-and-formatting/bundle?format=manifest and download each listed file from its "url" into mcore-linting-and-formatting/ in your skills directory; (3) if the SkillMD MCP tools are connected, call skillmd_download with slug "nvidia/mcore-linting-and-formatting" and save the returned files under mcore-linting-and-formatting/. Show me the SKILL.md before saving if you'd like me to review it. If your skills directory is read-only (e.g. the Claude desktop app), save the files to a working folder instead and tell me — I'll add them through my app's skills settings.

README badge

Show this skill's registry status in your repo:

[![SkillMD](https://skillmd.com/badge/nvidia/mcore-linting-and-formatting.svg)](https://skillmd.com/skills/nvidia/mcore-linting-and-formatting)

mcore-linting-and-formatting

Name: mcore-linting-and-formatting
Rating: 4.2 (5 reviews)
Author: NVIDIA

nvidia/mcore-linting-and-formatting · Agent Skill (multi-file)

by NVIDIA · bundle

Published Jun 29, 2026 · Last updated Jul 6, 2026

Lint and format Python code for Megatron-LM using ruff, black, isort, pylint, and mypy, with commands for autoformatting and import ordering.

SKILL.md

Linting and Formatting

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.

---
name: mcore-linting-and-formatting
description: Lint and format Python code for Megatron-LM using ruff, black, isort, pylint, and mypy, with commands for autoformatting and import ordering.
license: Apache-2.0
---

# Linting and Formatting

---

## Running the Formatter

Run before opening a PR:

```bash
# 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:

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

---

## Setting Up the Linting Group

Inside the container:

```bash
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.

Files

This skill is a package of 5 files. Install with the command above, or download the folder.

📄SKILL.md entry
📁evals
◆evals.json 2 B
📄BENCHMARK.md 2.8 KB
📄skill-card.md 2.5 KB
📄skill.oms.sig GitHub 0 B

NVIDIA/skills/tree/main/skills/mcore-linting-and-formatting commit · 63c02e122e

▌
python-excellence · paramchordiya
Enforces principal-engineer-level Python code quality: formatting, type safety, idiomatic patterns, class and function design, and anti-pattern prevention.

0
repo stars
▌
python-pro · jeffallan bundle
Generates type-safe, async-first Python 3.11+ code with full type annotations, mypy strict mode, pytest test suites, and validation via black and ruff.

10.4k
repo stars
▌
python-pro · antigravity
Write and review modern Python 3.12+ code with async patterns, performance optimization, and production-ready practices using the latest ecosystem tools.

42.4k
repo stars
▌
ruff-recursive-fix · github
Enforce code quality with Ruff in a controlled, iterative workflow: run checks with optional scope and rule overrides, apply safe and unsafe autofixes, review diffs, and resolve remaining findings.

36.2k
repo stars
▌
python-typing · schattenspiegel bundle
Design, review, debug, and test Python static types including Protocol, generics, variance, overloads, TypedDict, ParamSpec, TypeGuard, and narrowing.

0
repo stars
▌
validate · samyakjhaveri
Runs a two-wave validation pipeline (deterministic checks then rule-based checks) before every git commit, writing a sentinel file that a pre-commit hook enforces. Includes optional quick mode (first wave only) and a fix loop with up to three iterations.

0
repo stars

Frequently asked questions

How do I install the mcore-linting-and-formatting skill?

Run npx skillmds add nvidia/mcore-linting-and-formatting in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the mcore-linting-and-formatting skill do?

Lint and format Python code for Megatron-LM using ruff, black, isort, pylint, and mypy, with commands for autoformatting and import ordering. It is listed under Coding & Dev Tools, Code Review, Debugging on SkillMD.

Is mcore-linting-and-formatting safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with mcore-linting-and-formatting?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is mcore-linting-and-formatting free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published mcore-linting-and-formatting?

NVIDIA (@nvidia) published this skill as a verified publisher. Their other Agent Skills are listed on their SkillMD profile.