agentleFS
NVIDIAKnown publisherNVIDIA/Model-Optimizer/skills/modelopt-compare-results/SKILL.md

modelopt-compare-results

Skill5.6k starsChanged 3 days agoApache-2.0View on GitHub

Establish baseline-vs-candidate evaluation plans, delegate missing evaluations, compare validated results, and decide quantization feasibility. Use when the user asks to compare baseline vs quantized runs, explain an accuracy drop/regression, verify whether a quantized checkpoint is acceptable, or compare NEL/MLflow evaluation outputs. Do NOT use for generic single-model evaluation without comparison intent (use modelopt-evaluation), live NEL status/debugging (use modelopt-launching-evals), or generic MLflow browsing without a comparison goal (use modelopt-accessing-mlflow).

Trending

More talk lately.about the whole repository

Dec 2025: 0 mentionsJan 2026: 2 mentionsFeb 2026: 1 mentionMar 2026: 0 mentionsApr 2026: 2 mentionsMay 2026: 1 mentionJun 2026: 0 mentionsJul 2026: 0 mentionsAug 2026: 2 mentionsSep 2026: 20 mentionsOct 2026: 15 mentionsNov 2026: 11 mentions
Dec 2025Jun 2026Nov 2026
Mentions a month of the NVIDIA/Model-Optimizer repository that our weekly crawl found. There is no adoption data for this file yet.

Who's talking about NVIDIA/Model-Optimizer

The biggest 5 of 54 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 54

Talked about on GitHub and Bluesky (54 times).

On GitHub · 50

45 more on GitHub

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 6 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this to plan and complete a baseline-vs-candidate comparison.

    line 9
  2. Distinctive:

    If a required baseline or candidate evaluation is missing, delegate to the evaluation skill to create, run, and verify it.

    line 19
  3. Very specific:

    Use the evaluation skill's references/run-validation.md to perform the

    line 34
  4. Distinctive:

    Follow Assess results to compute deltas and uncertainty.

    line 41
  5. Distinctive:

    Before treating a baseline-vs-quantized delta as a model quality result, verify the validated runs are comparable:

    line 50
  6. Distinctive:

    If the requested gate is relative to BF16 and no BF16 baseline is available, report that gate as inconclusive.

    line 76
  7. Distinctive:

    If any item differs, either rerun with matched settings or label the result as not an apples-to-apples quantization comparison.

    line 83
  8. Very specific:

    Never report acceptable when external baseline sanity failed.

    line 112

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Compare Results

Use this to plan and complete a baseline-vs-candidate comparison. The baseline is the reference checkpoint, and the candidate is the checkpoint whose accuracy change is being measured, typically a further quantized version of the baseline.

Workflow

  1. Establish the candidate checkpoint/run and the matching baseline. Infer the baseline from the PTQ source model/checkpoint in the workspace or config used to create the candidate. If it cannot be inferred, ask the user for the baseline checkpoint or an existing baseline invocation/run path.
  2. If a required baseline or candidate evaluation is missing, delegate to the evaluation skill to create, run, and verify it. The companion evaluation config should match benchmark versions, task configs, serving args, token limits, dataset setup, credentials, cluster, and container as closely as possible; change only the model/checkpoint and checkpoint-specific serving or quantization flags.
  3. Fetch the baseline and candidate task list, configs, score artifacts, and logs. If the user provides MLflow runs or invocation IDs, use the accessing-mlflow skill to fetch configs and artifacts.
  4. Confirm each run passed evaluation Step 9, "Verify completed evaluation run", before comparing scores. If not, validate logs, server health, judge/code-execution status, sample accounting, and reasoning parsing before computing deltas.
  5. For each task, use the canonical score field from the matching evaluation skill task recipe, recipes/tasks/<task>.md, under Score Extraction.
  6. Use the evaluation skill's references/run-validation.md to perform the External Baseline Sanity Check. Record each source URL, protocol difference, and task status before applying the candidate-delta gate. A failed baseline blocks a success verdict; correct and rerun it first. If no credible comparable reference exists, label the baseline externally unverified rather than claiming the check passed, then continue using the validated measured baseline.
  7. Follow Assess results to compute deltas and uncertainty; mark unavailable uncertainty explicitly.
  8. Report comparability, external baseline sanity, and quantized-feasibility verdicts before interpreting the delta as model quality. If the user did not provide an acceptance threshold, report feasibility as inconclusive instead of inventing one.

Comparability Checklist

Before treating a baseline-vs-quantized delta as a model quality result, verify the validated runs are comparable:

  1. Prompt text, system prompt, chat template, and rendered messages match.
  2. Task name, benchmark version, dataset split, container, harness, and task fragment match.
  3. Generation settings match, including temperature, top_p, top_k, max tokens, stop strings, repetition detection, chat-template kwargs, reasoning mode/budget, and task-specific overrides.
  4. Reasoning traces are enabled, disabled, parsed, stripped, or ignored consistently between runs.
  5. The number of evaluated and scored samples/repeats matches for each task and split.
  6. Judge-backed or simulator-backed tasks use the same judge/user model, endpoint class, prompt, and scoring config.
  7. The same accuracy metric and score field is used for both runs.
  8. Timeout policies, effective limits, and failure scoring/exclusions match. Apply Timeout and Output-Limit Accounting in the evaluation skill's references/run-validation.md to both runs; matching limits alone cannot rule out serving-speed effects on scores.
  9. Baseline precision matches the gate. A <1pp vs BF16 gate requires a true full-precision (BF16) baseline. Many models ship natively quantized (e.g. INT4 W4A16 or block-wise FP8) with no BF16 release — a quant-to-quant comparison against the released precision (e.g. INT4 vs NVFP4, as for Kimi-K2.6) is still a valid result. State which precision the baseline is and apply only an acceptance criterion explicitly defined for that precision. If the requested gate is relative to BF16 and no BF16 baseline is available, report that gate as inconclusive; do not reinterpret it as an FP8/INT4 gate.

For SciCode, keep num_repeats: 1 and require at least 8 runs per side, comparing the two means — see the evaluation skill's recipes/tasks/aa/scicode.md. Fewer than 8 valid runs on a side is INDETERMINATE, not a delta.

If any item differs, either rerun with matched settings or label the result as not an apples-to-apples quantization comparison.

These checks compare the baseline and candidate to each other. The external baseline check in the evaluation skill's references/run-validation.md separately tests whether the baseline's absolute score is credible; both guards must be reported.

Report Format

Include:

  • Baseline and candidate identifiers.
  • Per-task metric path, baseline and candidate scores with SEs, signed loss (Candidate - Baseline for accuracy; negative is worse), confidence intervals and method, sample/run counts, and an Assessment column. Mark unavailable uncertainty explicitly; keep the assessment concise, not a statistics tutorial.
  • Per-task external reference score, source URL, known protocol differences, percentage-point difference, and sanity status (verified, failed, or externally unverified).
  • Comparability status for prompt/template, generation settings, sample counts, reasoning handling, judge/simulator setup, and score field.
  • Per-task timeout and output-limit counts/rates for both runs, explicit denominators, telemetry coverage, effective limits, and unresolved effects on the score. Unknown accounting or unresolved infrastructure effects prevent an acceptable quantization-feasibility verdict.
  • Comparability verdict: comparable, not comparable, or inconclusive.
  • Quantization feasibility verdict: acceptable, not acceptable, or inconclusive. Never report acceptable when external baseline sanity failed. An externally unverified baseline does not block acceptable; apply the candidate-delta gate and report the missing external corroboration.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.