Skip to content

[skills] chore: rename memory and moe config skills with nemo mbridge prefix - #4032

Merged
cuichenx merged 6 commits into
mainfrom
chore/sign-nemo-mbridge-batch-05
May 29, 2026
Merged

[skills] chore: rename memory and moe config skills with nemo mbridge prefix#4032
cuichenx merged 6 commits into
mainfrom
chore/sign-nemo-mbridge-batch-05

Conversation

@cuichenx

Copy link
Copy Markdown
Contributor

Summary

  • Rename this batch of public skills to the nemo-mbridge-* prefix:
    • nemo-mbridge-perf-memory-tuning
    • nemo-mbridge-perf-moe-dispatcher-selection
    • nemo-mbridge-perf-moe-hardware-configs
  • Add/keep license: Apache-2.0 frontmatter for these public skills.
  • Add placeholder evals/evals.json files where needed for NVSkills signing.
  • Update docs/skills-index.md references for the renamed skills.

Validation

  • Verified selected public skill directory names match SKILL.md frontmatter names.
  • Verified selected public skills have license: Apache-2.0.
  • Verified selected public skills have valid placeholder evals/evals.json files.
  • Verified selected public root SKILL.md files are <= 500 lines.
  • git diff --check passed.
  • uv run --no-sync pre-commit run --all-files passed.

@cuichenx

Copy link
Copy Markdown
Contributor Author

/nvskills-ci

templates already include it.
2. **Add selective activation recompute** (`recompute_modules=[core_attn]`) if
not already enabled. See @skills/perf-activation-recompute/SKILL.md.
not already enabled. See @skills/mbridge-perf-activation-recompute/SKILL.md.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: skills/mbridge-perf-activation-recompute/ does not exist. The actual directory is skills/perf-activation-recompute/. This reference (and the other three like it in this file) was incorrectly renamed — mbridge- is not a valid prefix for any existing skill.

If these skills are being renamed in a future PR, leave the old references for now and update them in that PR. Otherwise revert to the original paths:

Suggested change
not already enabled. See @skills/mbridge-perf-activation-recompute/SKILL.md.
not already enabled. See @skills/perf-activation-recompute/SKILL.md.

| Increase TP | Fewer params per GPU | Severe (-28% on 70B) | Last resort |
| Distributed optimizer | Shards optimizer state across DP ranks | ~1-2% | Recommended for large models |
| FSDP | Shards params + grads + optimizer | Varies | See @skills/perf-megatron-fsdp/SKILL.md |
| FSDP | Shards params + grads + optimizer | Varies | See @skills/mbridge-perf-megatron-fsdp/SKILL.md |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same issue: skills/mbridge-perf-megatron-fsdp/ does not exist — the actual path is skills/perf-megatron-fsdp/.

Suggested change
| FSDP | Shards params + grads + optimizer | Varies | See @skills/mbridge-perf-megatron-fsdp/SKILL.md |
| FSDP | Shards params + grads + optimizer | Varies | See @skills/perf-megatron-fsdp/SKILL.md |

### Activation recompute

See @skills/perf-activation-recompute/SKILL.md for full details.
See @skills/mbridge-perf-activation-recompute/SKILL.md for full details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
See @skills/mbridge-perf-activation-recompute/SKILL.md for full details.
See @skills/perf-activation-recompute/SKILL.md for full details.

Selective activation recompute with `mlp` saved ~3 GB peak memory but cost
~16% GPU utilization on this workload. See
@skills/perf-activation-recompute/SKILL.md for full results.
@skills/mbridge-perf-activation-recompute/SKILL.md for full results.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
@skills/mbridge-perf-activation-recompute/SKILL.md for full results.
@skills/perf-activation-recompute/SKILL.md for full results.

@claude

claude Bot commented May 28, 2026

Copy link
Copy Markdown
Contributor

Light Review

Broken cross-references in nemo-mbridge-perf-memory-tuning/SKILL.md (bug)

Four internal references were renamed to a mbridge- prefix that does not match any existing directory:

  • skills/mbridge-perf-activation-recompute/SKILL.md — actual path is skills/perf-activation-recompute/
  • skills/mbridge-perf-megatron-fsdp/SKILL.md — actual path is skills/perf-megatron-fsdp/

These should either stay as-is (pointing to the current names) or be updated in the same PR that renames those skills. See inline comments with suggested fixes.

Stale references in files not touched by this PR

Several files still reference the old (pre-rename) skill paths that no longer exist after this PR:

  • docs/training/moe-optimization.md — links to old skills/perf-moe-dispatcher-selection/ and skills/perf-moe-hardware-configs/
  • skills/perf-activation-recompute/SKILL.md (lines 31, 131) — links to old skills/perf-memory-tuning/
  • skills/perf-activation-recompute/card.yaml (line 95) — references old skills/perf-memory-tuning/
  • docs/training/activation-recomputation.md (line 197) — links to old skills/perf-memory-tuning/

These should be updated in this PR to point to the new nemo-mbridge- prefixed paths.


Suggested test cases

No perf tests impacted.

@yaoyu-33 yaoyu-33 added area:misc Cross-cutting utilities, logging, helpers, and other changes docs Documentation-only updates or documentation debt waiting-on-customer Waiting on the original author to respond labels May 28, 2026
Signed-off-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented May 28, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Signed-off-by: Chen Cui <chcui@nvidia.com>
@cuichenx

Copy link
Copy Markdown
Contributor Author

/nvskills-ci

@cuichenx cuichenx added the docs-only With great power comes great responsibility. label May 28, 2026
Signed-off-by: Chen Cui <chcui@nvidia.com>
@cuichenx

Copy link
Copy Markdown
Contributor Author

Scoped this signing PR back down to the renamed skill directories only. The cross-skill reference updates that touched old skill directories were moved to draft cleanup PR #4044 so NVSkills should not validate unrelated old skill dirs in this batch.

@cuichenx

Copy link
Copy Markdown
Contributor Author

/nvskills-ci

Signed-off-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
@cuichenx

Copy link
Copy Markdown
Contributor Author

/ok to test b431a82

Signed-off-by: Chen Cui <chcui@nvidia.com>
@cuichenx
cuichenx merged commit d606a98 into main May 29, 2026
3 checks passed
@cuichenx
cuichenx deleted the chore/sign-nemo-mbridge-batch-05 branch May 29, 2026 16:24
vasunvidia pushed a commit to vasunvidia/Megatron-Bridge that referenced this pull request Jun 10, 2026
… prefix (NVIDIA-NeMo#4032)

Signed-off-by: Chen Cui <chcui@nvidia.com>
Signed-off-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
Co-authored-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
Signed-off-by: Vasudevan Rengasamy <vrengasamy@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:misc Cross-cutting utilities, logging, helpers, and other changes docs Documentation-only updates or documentation debt docs-only With great power comes great responsibility. waiting-on-customer Waiting on the original author to respond

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants