Dev & Engineering ✓ NVIDIA · Official python-formattinglintingmegatron-coreruffblackisortpylintmypy

Megatron-Core Linting & Formatting

Standardize Megatron-LM Python checks and formatting before code review.

FollowSkills review · FSRS-2.0
Not recommended
51/ 100 5-point scale 2.6 / 5
Trust16 / 25 · 3.2/5

The skill only directs local linting and formatting tools; no malware, credential handling, or exfiltration is evident. It uses uv sync --locked, and the repository CI shows constrained permissions. Deductions apply because fix mode modifies files without explicit user confirmation, backup/rollback guidance, data-flow disclosure, execution isolation, or clear recovery boundaries.

Reliability8 / 20 · 2.0/5

The commands, tool list, and check/fix paths are broadly consistent, and the benchmark reports passing static validation. Deductions apply because autoformat.sh, pyproject.toml, and the relevant CI configuration are not included in the target skill evidence; abnormal inputs, missing tools, version incompatibility, and diagnostic failure handling are unspecified. Under static calibration, the score remains at or below 10.

Adaptability9 / 15 · 3.0/5

The audience, Megatron-LM context, trigger phrases, and main tools are reasonably clear, covering pre-PR checks and common lint issues. Deductions apply because non-fit cases, prerequisites, platform differences, and Chinese-language guidance are not stated. The container and uv assumptions limit environment fit, although the core function does not depend on overseas online services.

Convention8 / 15 · 2.7/5

Front matter supplies the name, description, author, and Apache-2.0 license; the skill card adds use case, output, version, owner, and references, while command examples support progressive use. Deductions apply for missing metadata.tags, Instructions, Examples, and Purpose sections noted by the report, plus limited FAQ/known-limitations coverage, no substantive changelog, and no clear maintenance/update path. Repository license metadata is NOASSERTION.

Effectiveness6 / 15 · 2.0/5

The skill gives directly reusable commands and style rules for the core Megatron-LM linting and formatting task, likely reducing manual lookup. Deductions apply because no actual outputs, remediation workflow, or result verification are shown, and users must still validate script and tool configuration. The benchmark provides no usable Tier 3 results, so static calibration limits the score to 7 or below.

Verifiability4 / 10 · 2.0/5

Commands, tool declarations, and benchmark static findings are reviewable, and the skill card provides a version and reference documentation. Deductions apply because the benchmark explicitly lacks Tier 3 task details, signals, and rollup, evals.json is empty, and no committed CI/test evidence covers this skill's key paths. Evidence is therefore limited to static material and remains at or below 5.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 55f18499943e
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • Fix mode directly changes source files; confirm the working-tree scope and create a recoverable version-control checkpoint before execution.
  • The guidance depends on tools/autoformat.sh, pyproject.toml, locked dependencies, and the container environment, so it may not run outside the corresponding Megatron-LM repository.
  • Tier 3 evaluation is unavailable; the reported PASS should not be interpreted as completed end-to-end validation.
  • Chinese-language guidance, systematic troubleshooting, and a tool-version compatibility matrix are not provided.
See the full review method →

What does this skill do, and when should you use it?

This skill provides linting and formatting guidance for Megatron-LM, within NVIDIA’s Megatron-Core skill collection. It explains how to run autoformat.sh in check or fix mode and how to use black, isort, pylint, ruff, and mypy. It also defines project style rules for public APIs, docstrings, naming, line length, and exception handling. It is a good fit for PR preparation and style-violation fixes, although the source does not document a platform matrix or standalone test suite.

Runs tools/autoformat.sh in check-only or fix mode; directs users to run uv run isort on edited Python files; installs the linting dependency group inside a container with uv sync --locked --only-group linting; and states rules for public API type hints, Google-style docstrings, Python naming, a 119-character line limit, and specific exception handling.

  1. A Megatron-LM contributor wants to validate formatting and linting before opening a PR.
  2. A developer needs to address pre-commit fails, ruff errors, isort issues, mypy errors, or other style violations.
  3. A contributor has edited Python imports and needs to reorder them according to project conventions.
  4. A team needs the same linting tools used by autoformat.sh and the CI linting job inside a container.

What are this skill's strengths and limitations?

Pros
  • Covers black, isort, pylint, ruff, and mypy, matching the tools named for autoformat.sh and CI linting.
  • Provides copyable commands for checking, fixing, import ordering, and dependency setup.
  • States concrete rules for public API typing, docstrings, naming, line length, and exception handling.
  • The collection README documents CLI installation targets including Codex, Claude Code, and Cursor.
Limitations
  • Focused on Megatron-LM Python style and linting rather than general code quality or testing.
  • The SKILL.md does not specify tool versions, operating-system support, or the full configuration files.
  • No standalone test suite, sample failure output, or verification results are provided.
  • Fix mode can modify files, so users should review their working-tree changes.

How do you install this skill?

Install the individual skill with the default skills CLI:

npx skills add nvidia/skills --skill mcore-linting-and-formatting --yes

Alternatively, run npx skills add nvidia/skills interactively and select the skill. The README does not specify a manual-copy destination for this individual skill.

How do you use this skill?

Trigger it with a relevant request such as: “pre-commit fails; help me run and fix Megatron-LM formatting checks.”

Check mode:
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

After editing Python imports:
uv run isort <file1>.py <file2>.py

Install the linting group inside the container:
uv sync --locked --only-group linting

FAQ

Does it run unit tests?
The source only describes formatting and static-analysis tools; it does not say that unit tests are run.
Does it require network access?
The skill describes no network calls. Dependency installation with uv may need to obtain uncached packages, but the source does not specify the network behavior.
Which projects does it target?
It explicitly targets Megatron-LM and its autoformat.sh, CI linting workflow, and Python style rules.
Will installation automatically change code?
Check mode applies no changes; fix mode uses CHECK_ONLY=false and applies formatting fixes.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

Megatron-Core Testing Guide

Design, run, and reproduce distributed Megatron-Core tests with CI-aligned workflows.

Dev & Engineering ✓ NVIDIA · Official

MoE Hardware Configuration Reference

Plan MoE training layouts and throughput expectations across NVIDIA GPU platforms.

Automation & Ops ✓ NVIDIA · Official

Megatron-Core CI Failure to Issue

Investigate failed GitHub Actions jobs and create structured bug issues for NVIDIA Megatron-LM.

Dev & Engineering ✓ NVIDIA · Official

NVIDIA cuOpt Developer

Guides source-level cuOpt modification, builds, tests, debugging, and contributions.

Dev & Engineering ✓ NVIDIA · Official

NeMo Relay Installation Guide

Choose and verify the right NeMo Relay path for CLIs, language packages, and maintained frameworks.

Dev & Engineering ✓ NVIDIA · Official

NeMo MBridge GPU Memory Tuning

Diagnose GPU OOMs in Megatron Bridge training and reduce fragmentation, activation, and PEFT memory usage.

Dev & Engineering ✓ NVIDIA · Official

NeMo Relay Quick Start

Helps first-time NeMo Relay users prove observable execution value through the smallest suitable trial.

Data & Analysis ✓ NVIDIA · Official

DICOM Series Preflight

Header-only validation for one DICOM series before conversion or inference.

Dev & Engineering ✓ NVIDIA · Official

Megatron Bridge Activation Recompute

Trade extra compute for lower GPU activation memory in Megatron Bridge training.

Dev & Engineering ✓ NVIDIA · Official

DALI Dynamic Mode Assistant

Helps agents write, review, and migrate NVIDIA DALI imperative dynamic-mode code.

Dev & Engineering ✓ NVIDIA · Official

NeMo Evaluator Plugin Skill

Run and manage NeMo Platform model evaluations through the Evaluator CLI and Python SDK.

Dev & Engineering ✓ NVIDIA · Official

NeMo MBridge Parallelism Strategy Guide

Choose, combine, and validate Megatron Bridge parallelism configurations.

Writing & Content ✓ NVIDIA · Official

Skill Card Generator

Generates or refreshes governance cards for existing agent skills.

Dev & Engineering ✓ NVIDIA · Official

NeMo MBridge MoE Expert-Parallel Overlap

Configure, validate, and troubleshoot MoE expert-parallel communication overlap in Megatron-Bridge.

Dev & Engineering ✓ NVIDIA · Official

NeMo MBridge MoE VLM Training Guide

Guides FSDP and 3D-parallel choices and tuning for MoE vision-language model training.

Dev & Engineering ✓ NVIDIA · Official

NeMo MBridge Training Resiliency

Configure fault recovery and hang detection for Megatron Bridge distributed training.

Dev & Engineering ✓ NVIDIA · Official

NeMo Relay Migration Assistant

Safely migrate NeMo Flow projects to NeMo Relay.

Dev & Engineering ✓ NVIDIA · Official

Earth2Studio Diagnostic Builder

Build Earth2Studio wrappers for single-step diagnostic data transformations.

Data & Analysis ✓ NVIDIA · Official

Earth2Studio Weather Data Fetch

Fetch validated weather and climate variables from Earth2Studio sources by time and data type.

Dev & Engineering ✓ NVIDIA · Official

Earth2Studio Installation Guide

Helps users install Earth2Studio and configure model extras and environment settings safely.

Related skills