Agent skill

Veomni Review

by ByteDance-Seed in ByteDance-Seed/VeOmni

Pre-PR code review gate. An agent skill from ByteDance-Seed/VeOmni.

Apache-2.0Auto-check passedDevelopment

Install Veomni Review

skills CLI
$ npx skills add ByteDance-Seed/VeOmni --skill veomni-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ByteDance-Seed/VeOmni veomni-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ByteDance-Seed/VeOmni.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/veomni-review .claude/skills/veomni-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
veomni-review
GitHub stars
2.2k
Token cost
~1.9k tokens
SKILL.md length
517 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Pre-PR code review gate. An agent skill from ByteDance-Seed/VeOmni.

  • Works in 4 steps: Capture the diff the PR will actually… → Read .agents/knowledge/constraints.md… → Launch a review subagent with your… → …
  • Proactively for runtime
  • SKILL.md covers When this gate applies, Steps, Subagent Launch and After Commit
  • Calls git and make

What it does

Veomni Review is an agent skill from ByteDance-Seed/VeOmni. Pre-PR code review gate. Run before opening a pull request, and again before pushing a substantive update to an open one — not per commit. Required when the PR's branch diff touches Python under veomni/, tasks/ or tests/, or CI workflows, pyproject.toml, uv.lock, docker/ or configs/. Also trigger proactively for runtime or configuration changes that span multiple files, touch shared infrastructure (BaseTrainer, distributed, model loading, data pipeline, ops dispatch), or have uncertain safety. Docs, comments and…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Verification before completion, Subagents and Data pipelines and ETL. It works with Docker and Python. The repository describes itself as: VeOmni: Scaling Any Modality Model Training with Model-Centric Distributed Recipe Zoo. The licence is Apache-2.0.

When your agent uses it

  • Proactively for runtime
  • Configuration changes that span multiple files
  • Touch shared infrastructure (BaseTrainer
  • Have uncertain safety

Example prompts

  • “/veomni-review”

Requirements

  • Python 3
  • Docker

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Capture the diff the PR will actually contain — the whole branch against the
  2. Read .agents/knowledge/constraints.md for known constraints.
  3. Launch a review subagent with your agent's subagent/task mechanism (see
  4. Act on the verdict.

What it can do on your machine

Read from SKILL.md and the folder at commit 8791a71. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Veomni Review loads about 1.9k tokens when it runs. Until then it costs about 189 tokens; SKILL.md has 517 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~189
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ByteDance-Seed/VeOmni at commit 8791a71, republished under its Apache-2.0 licence (© ByteDance-Seed). 517 words, ~1,942 tokens.

Download SKILL.mdSave it as .claude/skills/veomni-review/SKILL.md (or your agent's skills folder).
name
veomni-review
description
Pre-PR code review gate. Run before opening a pull request, and again before pushing a substantive update to an open one — not per commit. Required when the PR's branch diff touches Python under veomni/, tasks/ or tests/, or CI workflows, pyproject.toml, uv.lock, docker/ or configs/. Also trigger proactively for runtime or configuration changes that span multiple files, touch shared infrastructure (BaseTrainer, distributed, model loading, data pipeline, ops dispatch), or have uncertain safety. Docs, comments and .agents/-only changes use the self-check below. The review launches a subagent that checks implementation quality, multi-file consistency, and known constraint violations, then rates the change as safe/needs-attention/risky.

When this gate applies

Once per PR, not once per commit. The unit that lands is the pull request, so that is the unit worth reviewing: the reviewer sees the whole change instead of a slice of it, and a branch of ten commits costs one review rather than ten. Run it again before pushing a substantive update to an open PR — not for a typo fix or a rebase.

Commits stay cheap: make quality and your own verification still gate every commit, and nothing stops you invoking this mid-branch when a change worries you. It is the obligation that moved, not the option.

The PR's branch diff touchesReview
Python under veomni/, tasks/, tests/Required
.github/workflows/, pyproject.toml, uv.lock, docker/, configs/Required
Docs, comments, or .agents/ knowledge and skills onlySkip — self-check instead: verify every repo path, config key and version you assert actually exists, and that every #L<line> code link lands on the symbol it names
A clean, exact revert or reapplication of a previously approved diff, with no additional or conflict-resolved changesSkip

Partial reverts and reapplications with extra edits or conflict resolutions must follow the normal review gate; prior approval does not cover those changes.

Skipping means skipping the subagent, not skipping verification. Say which branch you took, so the reader knows a review happened or why it didn't.

Steps

  1. Capture the diff the PR will actually contain — the whole branch against the base it targets, not the working tree:

    bash
    git diff <base>...HEAD          # <base> is the branch the PR targets

    Use three dots: it diffs from the merge base, so commits that landed on <base> after you branched do not show up as your changes. <base> is usually main, but for a stacked PR it is the branch below yours — diffing against main there would hand the reviewer every PR under you as well.

    If you still have uncommitted work you want included, add it too, and note that a plain git diff sees neither staged nor untracked files:

    bash
    git add -N .                    # intent-to-add: new files become visible, stages no content
    git diff HEAD

    git diff HEAD covers staged and unstaged tracked files; git add -N is what makes a brand-new module or test visible at all, and it respects .gitignore so build artifacts stay out.

  2. Read .agents/knowledge/constraints.md for known constraints.

  3. Launch a review subagent with your agent's subagent/task mechanism (see the prompt below). The subagent receives only the diff + constraints — NOT your reasoning — to avoid confirmation bias. Point it at the diff command rather than pasting, so it reads the current state.

  4. Act on the verdict.

Show full SKILL.md (108 more words)Show less
VerdictAction
safeOpen or update the PR
needs-attentionAddress the listed issues, then open or update the PR
riskyOutput the report, do NOT open the PR, wait for the user
  1. Run make quality before pushing. (It gates every commit anyway, but this is the last chance before the diff is public.)

Subagent Launch

Launch a subagent with this prompt. Use whatever the running agent calls it — Task, spawn_agent, or an equivalent — and give it read-only access to the repo so it can verify claims against the actual files.

You are a code reviewer for VeOmni, a distributed multi-modality training framework. Your job is to find problems in the following diff. You are NOT validating the author's intent — you are looking for bugs, risks, and constraint violations.

## Diff
<paste full git diff here>

## Known Constraints
<paste constraints.md content here>

## Review Checklist

For each changed file, check:

### Implementation Quality
- Hidden risks or edge cases not handled?
- Simpler alternative that achieves the same result?
- Boundary conditions (tensor shapes, distributed rank handling, gradient accumulation steps)?
- Does the fix depend on downstream code to "clean up"?

### Multi-file Consistency
- If a Trainer method changed, do all subclasses need matching changes?
- If model loading changed, are configs and parallel plans updated?
- If data collator changed, do all modalities still work?
- If distributed code changed, are the FSDP2, sequence-parallel and ExtraParallel/EP paths all handled? (FSDP1 no longer exists — a diff that adds an FSDP1 branch is itself a finding.)
- If a trainer lifecycle hook changed, do the composed trainers that override `forward_backward_step()` (`TextDPOTrainer`, `DiTTrainer`) still get it?

### Constraint Violations
- Does this violate any entry in the known-constraints list?
- Does this repeat a pattern that previously caused bugs?

### VeOmni-Specific Checks
- PR title format: `[{modules}] {type}: {description}`?
- All comments and docstrings in English?
- No auto-generated files (`veomni/models/transformers/*/generated/`) edited directly?
- Tests: does the diff extend an existing CI-enumerated test, or add a new file that the workflow owning that path actually lists? Check the owning workflow rather than assuming — `tests/data/` runs wholesale in both unit workflows, `tests/ops/` only in the GPU one (NPU enumerates ops files by name, so an Ascend-relevant ops file still needs a line), the e2e paths belong to `{gpu,npu}_e2e_test.yml`, and everything else must be listed file by file or it never runs. See `.agents/knowledge/testing.md`.
- Ruff-compliant (`make quality` passes)?

### Documentation
- Does the diff add or change a public API, config field, or extension point (a mixin, hook, callback or base-class method that other modules or models must implement)? Then the same PR must add or update a page under `docs/`. A missing page is a needs-attention finding.
- A new extension point needs a dedicated page that states, for each function: who owns it (must implement / must call / may override / framework-provided), what it does, the exact framework call site, and the observable end effect. The full requirements are in "Documenting an extension point" in `.agents/skills/veomni-develop/SKILL.md`.
- Is every new page in a `docs/index.md` toctree? The docs build runs with `-W`, so an orphan page fails CI.
- Do code references use paths relative to the doc with `#L<line>` anchors, and does each anchor land on the symbol its link text names? Check every anchor into a file this diff changes; line numbers shift silently.
- Do the doc's claims (function names, call order, metric or config keys, defaults) match the code in the diff?

## Output

### Verdict: safe / needs-attention / risky

### Findings (for needs-attention or risky)
For each issue:
- **File**: path:line
- **Concern**: what could go wrong
- **Suggestion**: what to do instead

After Commit

  • Run make quality to confirm ruff compliance.
  • Verify PR title follows [{modules}] {type}: {description} format.

© ByteDance-Seed, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/veomni-review of ByteDance-Seed/VeOmni.

Open the folder on GitHubat commit 8791a71

Compare with similar skills

Veomni Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Veomni Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Veomni Review this skillByteDance-Seed/VeOmni2.2k—~1.9kAutomated safety check: PassApache-2.0
Deploying Go SDK Bundlesastronomer/agents451—~1.8kAutomated safety check: NotesApache-2.0
Version Bumpergodatadriven/whirl205—~1.2kAutomated safety check: PassApache-2.0
CI Act Runchewiebug/GCViewer4.6k—~2.4kAutomated safety check: NotesCustom licence
Curate Whats Newdocker/docs4.7k—~1.3kAutomated safety check: PassApache-2.0
Review PRmicrosoft/vscode-containers141—~900Automated safety check: PassCustom licence

Similar skills

  • Deploying Go SDK Bundles

    astronomer/agents

    Builds, packs, and deploys compiled Airflow Go SDK bundles so the ExecutableCoordinator can run them.

    451 GitHub stars~1.8k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check: notes
  • Version Bumper

    godatadriven/whirl

    Bump the Airflow or Python version across all project files.

    205 GitHub stars~1.2k tokensUpdated 9 days ago
    Data & AnalyticsAuto-check passed
  • CI Act Run

    chewiebug/GCViewer

    Run the full build-and-deploy.yaml workflow locally via act + Docker.

    4.6k GitHub stars~2.4k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Curate Whats New

    docker/docs

    Official

    Curate noteworthy Docker launches from documentation pull requests merged during a requested period.

    4.7k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Review PR

    microsoft/vscode-containers

    Official

    Review a specific vscode-containers pull request on demand from the CLI (or any interactive agent), the way a Container Tools maintainer would.

    141 GitHub stars~900 tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Release

    Pipelex/pipelex

    Cut a release of pipelex, which ships the pipelex and pipelex-api packages and the pipelex/pipelex-api Docker image under one version: the gates, the migration-ledger cross-check, the CHANGELOG.md…

    942 GitHub stars~4.8k tokensUpdated today
    DevelopmentAuto-check: notes

More from ByteDance-Seed/VeOmni

All 10 skills in this repo
  • Create PR

    ByteDance-Seed/VeOmni

    Create a pull request for the current branch. An agent skill from ByteDance-Seed/VeOmni.

    2.2k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Veomni Debug

    ByteDance-Seed/VeOmni

    A skill your agent uses for ANY bug, error, crash, wrong output, loss divergence, gradient explosion, test failure, CUDA error, distributed training hang, checkpoint load failure, or unexpected…

    2.2k GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Veomni New Model

    ByteDance-Seed/VeOmni

    A skill your agent uses when adding support for a new model to VeOmni.

    2.2k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Veomni New Op

    ByteDance-Seed/VeOmni

    A skill your agent uses when adding a new optimized kernel or operator to veomni/ops/.

    2.2k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Veomni Patchgen Model

    ByteDance-Seed/VeOmni

    Author or refresh a VeOmni model's patchgen-generated modeling under generated/ — GPU and/or NPU config, dense or MoE, text / VLM / Omni.

    2.2k GitHub stars~9.6k tokensUpdated yesterday
    Auto-check passed
  • Veomni Profile

    ByteDance-Seed/VeOmni

    A skill your agent uses for performance profiling and optimization.

    2.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Veomni Review

What does Veomni Review do?

Pre-PR code review gate. An agent skill from ByteDance-Seed/VeOmni. Veomni Review is an agent skill from ByteDance-Seed/VeOmni. Pre-PR code review gate.

When should I use Veomni Review?

Veomni Review fits situations like: proactively for runtime; configuration changes that span multiple files; touch shared infrastructure (BaseTrainer; have uncertain safety.

How do I install Veomni Review in Claude Code?

Run `npx skills add ByteDance-Seed/VeOmni --skill veomni-review -a claude-code`. Or copy the skill folder (.agents/skills/veomni-review in ByteDance-Seed/VeOmni) into .claude/skills/veomni-review in your project. Claude Code loads it when a task matches its description.

How do I install Veomni Review in Codex?

Run `npx skills add ByteDance-Seed/VeOmni --skill veomni-review -a codex`. Or copy the skill folder (.agents/skills/veomni-review in ByteDance-Seed/VeOmni) into .agents/skills/veomni-review in your project. Codex loads it when a task matches its description.

Can I use Veomni Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ByteDance-Seed/VeOmni --skill veomni-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/veomni-review, .gemini/skills/veomni-review, .github/skills/veomni-review and .opencode/skills/veomni-review in your project.

What does Veomni Review need to run?

Going by SKILL.md and its folder, Veomni Review needs the command-line tools its instructions call (git and make). Our summary lists: Python 3; Docker.

Does Veomni Review access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Veomni Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Veomni Review use?

Veomni Review is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Veomni Review use?

About 1.9k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Veomni Review?

Skills that share tags, products or a category with Veomni Review: Deploying Go SDK Bundles (astronomer/agents, 451 stars), Version Bumper (godatadriven/whirl, 205 stars), CI Act Run (chewiebug/GCViewer, 4.6k stars) and Curate Whats New (docker/docs, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Veomni Review?

ByteDance-Seed (a GitHub organization) maintains it in ByteDance-Seed/VeOmni, which has 2,235 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 2026.

Source: ByteDance-Seed/VeOmni on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.