Repository navigation
cosmos3-generate-media skill (cookbook → skill migration) with eval-derived fixes, cosmos3-skill-authoring guide, opt-in skill-eval CI - #324
Conversation
… notebooks) Migrates the cookbooks/cosmos3/generator/audiovisual notebooks and README 1:1 into the cosmos3-generate-media agent skill: SKILL.md (one smoke path per serving variant, quoted from the notebooks, the README or the setup guide), references/ (one file per backend plus payloads.md for the shared content), assets/ (sample prompts, reference images, negative prompts) and eval/ (11 cases). The six notebooks and the audiovisual README are retired from .agents/skills/cookbooks/; the cookbook READMEs and the docs site link to the skill instead. The cell-by-cell record is docs/cookbook_to_skill_migration.md. The three sample JPEGs under assets/images/ are plain blobs: a nested .gitattributes exempts them from the repository's LFS rule because the skill-eval checkouts and the agents' task containers fetch without LFS. Migrated from the private review as a diff on top of main. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
Adds .github/workflows/skill-eval.yml and the orchestrator .github/scripts/skill_eval/ (run_matrix.py, its README and unit tests, the cosmos3-ci-smoke canary): a trigger label, a /run-skill-eval comment or a manual dispatch evaluates the skills a PR touches — one job per case × agent on the runners labelled cosmos-skill-eval + h100 (cursor cells serialised on the cursor-serial runner), one live PR comment per head commit, results keyed by skill content and reused across commits that do not change the skill, the inference key from the repository secret COSMOS_SKILL_EVAL_NVIDIA_API_KEY, the evaluator image and dashboard URL from the repository variables COSMOS_SKILL_EVAL_IMAGE / COSMOS_SKILL_EVAL_DASHBOARD. Nothing runs on push or merge. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…aude Sonnet 5.5 A GitHub-hosted gate job (no checkout) now precedes plan: it reads the role of the person who commented, applied the label or dispatched from the collaborators API and admits only write, maintain or admin on this repository — organisation membership or a read/triage role is refused before any self-hosted runner is used; fork heads stay refused in plan. A refused comment gets a 😕 reaction. cursor_model (.github/skill-eval.yml, handed to the evaluator container as COSMOS_EVAL_CURSOR_MODEL for cursor cells) selects Claude Sonnet 5.5 through Cursor's backend instead of the evaluator's Composer default, so the four agents exercise four model families. README updated; 106 unit tests. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…nt skill The authoring guide distilled from the generate-media migration: description and trigger boundaries, structure and section order, commands that pass the eval on the first attempt, how the evaluator judges, eval.config rules, running the eval in CI (triggers, who may start a run, the PR comment, the dashboard) or locally, the fix loop with a stacked fixes PR, and submitting (references/running-the-eval.md). Generic by design; the generate-media skill is the worked example. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…hin Variant 7, nim.md removed) Upstream retired the Generator NIM 1.0.0 (#296): run_with_nim.ipynb is gone and the audiovisual README's "Run with NIM" quickstart targets the unified Cosmos3 NIM nvcr.io/nim/nvidia/cosmos3:2.1.0 (NIM_MODEL_TYPE=generator, NIM_MODEL_VARIANT, model_mode requests with input_reference / num_inference_steps / num_frames, a third guardrail switch). Instead of rebuilding references/nim.md from the cookbook, Variant 7 delegates to .agents/skills/cookbooks/cosmos3/nim/ (deployment, generation, api-reference, operations) and its cosmos3-nim-user skill: SKILL.md keeps the pointers, the README's 2.1.0 launch (CONTAINER_NAME / NIM_PORT / NIM_IMAGE as parameters), the readiness and selection checks of deployment.md, the examples/i2v.py request built from the bundled assets at smoke size, and the README scope quote; payloads.md takes the 2.1.0 scope, guardrail, image and request wording; the guardrail table adds NIM_ENABLE_SIGLIP_GUARDRAILS. Record: last section of docs/cookbook_to_skill_migration.md. eval/eval.config is unchanged. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
Skill eval — b50b766 · run #4063948032244 / 44 cells done · 42 passed · 2 failed · 0 no report · 0 errors · 0 reused · started 2026-10-28 05:42:05 UTC · updated 2026-10-28 08:56:13 UTC
|
| Case | claude | codex | cursor | opencode |
|---|---|---|---|---|
diffusers-edge-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
diffusers-edge-t2v |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
framework-edge-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
vllm-omni-edge-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
sglang-edge-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
trtllm-edge-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ❌ FAIL · report |
distilled-trtllm-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ❌ FAIL · report |
nim-generator-i2v |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
diffusers-nano-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
framework-nano-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
trtllm-nano-t2i |
✅ PASS · report | ✅ PASS · report | ✅ PASS · report | ✅ PASS · report |
Not evaluated
cookbooks— eval.config not found at.agents/skills/cookbooks/eval/eval.configcosmos3-skill-authoring— eval.config not found at.agents/skills/cosmos3-skill-authoring/eval/eval.config
Legend: ⏳ queued · 🟢 running · ✅ PASS · ❌ FAIL · cells= with no result of this skill version yet · (not re-run: n report-less attempts) = 3 consecutive NO-REPORT/ERROR results for this skill version, treated as a harness-side failure (force or cells= re-runs it) · not run = the runner lost docker (job stopped)
❌ done — 42/44 passed (2 failed, 0 no report, 0 errors)
…or default) in the config Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
docs/cookbook_to_skill_migration.md (the cell-by-cell migration record and the eval-derived fix notes) is removed from the public tree together with its docs-nav entry; the authoring skill points at the fixes PR instead of the record. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…x a relative path in payloads.md The authoring skill and its eval guide referred to the pull requests, dashboard groups, commits and branch names of the repository the skill was developed in; they now cite this repository's #324 / #327, the groups ci-pr324-b50b766 and ci-pr327-b7ad087 and the public branch names. references/payloads.md: the NIM api-reference link is written from references/, so it needs ../../cookbooks/. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
lfengad
left a comment
There was a problem hiding this comment.
Thanks for putting this migration and the opt-in evaluation workflow together. I have left a few inline notes on preserving the existing public entry point and bounding selective runs, plus a non-blocking cache suggestion.
| - Deploy with NIM: skills/cookbooks/cosmos3/nim/README.md # the other NIM pages are extra_pages | ||
| - Notebooks: | ||
| - Generation: skills/cookbooks/cosmos3/generator/audiovisual/README.md | ||
| - Generation: skills/cosmos3-generate-media/SKILL.md |
There was a problem hiding this comment.
Could we please retain a small migration README at the previous audiovisual README path, or coordinate the public shortcut update before removing it? The public Cosmos COOKBOOK.md still uses https://nvda.ws/4z3OmbC for Generation; I checked that it currently redirects to cosmos-framework/blob/main/.agents/skills/cookbooks/cosmos3/generator/audiovisual/README.md. Updating this navigation entry does not preserve that external entry point, so removing the old README would leave those users with a broken link. A short pointer to the new skill would preserve compatibility without restoring the notebooks.
There was a problem hiding this comment.
Thanks for catching, we will update the redirect from cosmos cookbook once this merges.
There was a problem hiding this comment.
PR to update cosmos cookbook: NVIDIA/cosmos#390
| options.errors.append( | ||
| f"`{token}`: cells are `<backend>/<case>` or `<skill>/<backend>/<case>` patterns, comma-separated" | ||
| ) | ||
| options.cells.extend(pattern for pattern in patterns if "/" in pattern) |
There was a problem hiding this comment.
Could we please stop planning when an explicitly supplied cell selection is invalid, rather than dropping it and continuing? For example, force cells=codex records a syntax error but leaves options.cells empty; selects() treats an empty list as selecting every cell, and force disables cache reuse. A typo in an intended selective rerun can therefore launch the entire matrix. Without force, the same expansion affects uncached cells. Rejecting the invalid selection before scheduling jobs would keep the default full run for an intentionally argument-free request, without unexpectedly widening an explicit request.
There was a problem hiding this comment.
Done in f8041fe: an empty or malformed cells=/rerun selection now fails the plan with the syntax error posted on the PR, and no cell job is scheduled; a trigger without arguments still runs the full matrix. Test added.
| def matches(self, run: Mapping) -> bool: | ||
| """Is this catalog run an evaluation of this skill version? (content sha, else an equivalent commit)""" | ||
| skill_block = run.get("skill") if isinstance(run.get("skill"), dict) else {} | ||
| if self.content_sha256 and skill_block.get("content_sha256") == self.content_sha256: |
There was a problem hiding this comment.
Non-blocking suggestion: could we consider including an evaluation-environment fingerprint, or an explicit cache epoch, in result compatibility? This match currently uses skill content/equivalent commits, with the case and backend matched separately, but the evaluator image and configured agent models can change independently in .github/skill-eval.yml or repository variables. The same skill could then reuse a PASS/FAIL from a different evaluation environment. I understand that reuse is disclosed and force is available, so I am not treating this as a blocker; an image/model fingerprint or a documented cache-invalidation step on environment changes would make the scope of cached evidence clearer.
There was a problem hiding this comment.
Done in f8041fe: a published result is reused only if its recorded evaluator image and, where the config sets one, the backend model match the current config; otherwise the comment shows "♻️ Cache: n published results … not reused — environment changed (…)" and the cell runs again. Manifests without env.image (evaluator < 0.3.3) are matched on content as before. Test added, README updated.
The serialisation (serial_backends: [cursor] + the cursor-serial runner label) guarded against Cursor-side rejections seen while the cursor backend ran Composer 2.5 (2026-10-26: 2 of 7 concurrent cells died with [resource_exhausted]). With Claude Sonnet 5.5 as the cursor model (image >= v20261102) the 11 cursor cells of cosmos3-generate-media ran four at a time on 2026-10-29: 11/11 PASS, 11/11 first attempt, no rejection and no retry in any run. serial_backends is now an explicit empty list (the orchestrator default would still pin cursor); the label stays on one runner so pinning can be re-enabled with one config line. Comments, README, eval guide and the live-config test follow. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…s only from the same environment Review follow-ups on #324: - A `cells=` / `rerun` list that is empty or malformed (e.g. `force cells=codex`) no longer degrades to an empty selection, which selects every cell: the plan posts the syntax error on the PR and stops without scheduling a job. Unknown tokens keep the previous behaviour (reported, defaults used) because they can only narrow a run. - A published result is reused only if its manifest's evaluator image (env.image) and, for a backend with a configured model, its recorded agent model match the current config; otherwise the cell runs again and the comment header says "Cache: n published results … not reused — environment changed (image v20261101 → v20261102)". Manifests without env.image (evaluator < 0.3.3) are matched on skill content as before. The marker travels in the plan JSON. Tests for both; README documents the two rules. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
… (launch mounts, HF_TOKEN, FP8 checkpoints) PR #329 changed run_with_vllm_omni.ipynb and the audiovisual README after this skill's pin and before their retirement here. The skill now mirrors that final version 1:1: references/vllm-omni.md § 2 carries the revised docker launches (`-v "$PWD:/workspace" -v "$PWD:$PWD" -w /workspace -e HF_TOKEN` and the Hugging Face cache mount) and the new "Quantized Checkpoints" section (Nano/Super FP8 served from a local directory), its § 3 note describes the notebook's framework-root resolution, SKILL.md Variant 3 quotes the new Nano launch (+ --no-guardrails), and payloads.md § 1 carries the README's pointer to the quantization cookbook (link rewritten to this repository: ../../cookbooks/cosmos3/quantization/, which arrives with the merge of main that follows). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
The audiovisual README and run_with_vllm_omni.ipynb, modified on main by #329 and retired by this branch, stay deleted: their final content is in the skill (references/vllm-omni.md § 2, payloads.md § 1 — the previous commit). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…nt where) A one-table record of the retirement: each file of cookbooks/cosmos3/generator/audiovisual/ and the skill file or section that carries it now, with the final-version note for the vLLM-Omni notebook and the NIM delegation. Listed under not_on_site in the docs nav like the other repo-only pages. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
|
| Case | claude | codex | cursor | opencode |
|---|---|---|---|---|
vllm-omni-edge-t2i |
✅ PASS · 2.17M · 4m43s | ✅ PASS · 1.71M · 4m07s | ✅ PASS · 468K · 2m45s | ✅ PASS · 1.77M · 7m18s |
Tokens (all cells): 6.11M. Legend: ✅ PASS · ❌ FAIL · ↻ = passed after self-correction (none here) · tokens = the agent's total · duration = the cell's wall time.
🤖 Generated with Claude Code
## Summary **Stacked PR:** based on #324's branch `skills/generate-media-migration-and-eval-public`; merge this PR into that branch first, then #324 carries both to `main`. Skill-only: `.github` is identical to the base. Follow-up to #324: fixes every fatal failure and repeated self-correction of the `cosmos3-generate-media` eval matrix (11 cases × claude, codex, cursor, opencode). Baseline (group `ci-pr324-b50b766`): 42/44 PASS, 14/44 first-attempt. With the fixes (group `ci-pr327-b7ad087`): 44/44 PASS, 44/44 first-attempt. `eval/eval.config` is unchanged from the base branch, so before and after are measured on the same prompts, assertions and checks. Notebook-verbatim text in `references/` stays verbatim; every skill addition is a marked skill note ("Skill note (not in the notebook): …") or a declared in-block deviation. ### Fixes Where = `file:lines` at `55f0f0f` (permalinks; `SKILL.md` = `.agents/skills/cosmos3-generate-media/SKILL.md`, reference names = `references/<name>`). Problem → fix, in priority order; F2d was added after the validation run (see Validation). | ID | Pri | Problem | Fix applied | Where | |---|---|---|---|---| | F1 | P0 | Variant 5 gave only the Docker devel source build (tag left `<tag>`) plus a dead `TRTLLM_USE_PRECOMPILED` hint; no wheel version anywhere, so cursor/opencode pip-installed stable 1.2.x, which lacks VisualGen | Route A (default): prebuilt wheel `tensorrt_llm==1.3.0rc27` + `torch==2.13.0+cu130` from pypi.nvidia.com/cu130 (uv `--index-strategy unsafe-best-match`), VisualGen preflight, pinned checkout for YAMLs only; Route B = source build; mirrored as skill notes in trt-llm.md / distilled-trt-llm.md | SKILL.md [296–299](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L296-L299) · distilled-trt-llm.md [61](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L61) · trt-llm.md [29](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L29) [583–589](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L583-L589) [595–639](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L595-L639) [656–658](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L656-L658) [722](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L722) | | F2 | P1 | Framework `pyproject.toml` pins uv `==0.11.29`; `uv venv/pip/sync` abort with uv 0.13 and `uv self update` refuses | Variant 1: `--no-config`; Variant 2: pinned-uv preflight (side-by-side install or `uvx --from 'uv==0.11.29'`); one note in "Read this first"; skill notes in diffusers.md, cosmos-framework.md, payloads.md | SKILL.md [31–35](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L31-L35) [104–108](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L104-L108) [120](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L120) [142–143](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L142-L143) [177–184](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L177-L184) · cosmos-framework.md [202](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/cosmos-framework.md#L202) [409–410](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/cosmos-framework.md#L409-L410) · diffusers.md [136](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L136) [138](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L138) [157](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L157) · payloads.md [85](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L85) [99](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L99) | | F2b | P1 | An agent installed uv 0.11.29 (the Variant 2 preflight) for the TRT-LLM venv; that uv cannot resolve `nvidia-cutlass-dsl==4.8.0.dev0` without `--prerelease=allow`, which then pulls mpmath 1.5.0a1 | "Read this first" / Variant 5 / Variant 2 state which uv each variant uses (stock 0.13+ with `--no-config` for Variants 1/5/6; 0.11.29 only for `uv sync`) | SKILL.md [36–37](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L36-L37) [183](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L183) · skill-notes.md [141–145](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L141-L145) · trt-llm.md [605](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L605) | | F2c | P1 | In a full run of the fixes branch the opencode agent ran the Variant 1 install block across separate shell calls; the `export` and `source …/activate` of the first call were gone in the second, so `uv pip install` went into the evaluator's own venv and the import check ran against the wrong interpreter (then a needless OpenCV downgrade: the same block passed first-attempt in the other eleven diffusers cells of that run) | The three `uv pip` commands of the Variant 1 block and of diffusers.md § 3 carry `--python "$COSMOS3_DIFFUSERS_VENV"` (declared in-block addition; with the variable unset uv stops instead of installing elsewhere), the import check and the generation snippets run with `"$COSMOS3_DIFFUSERS_VENV/bin/python"`, and the block says it is one shell call | SKILL.md [110–126](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L110-L126) · diffusers.md [138–151](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L138-L151) [157](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L157) [161](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L161) [453–454](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L453-L454) | | F3 | P1 | Diffusers venv not headless: `cosmos_guardrail` pulls GUI opencv; the pipeline imports it even with the safety checker off | Headless OpenCV swap + import check inside the Variant 1 venv block; apt fallback reworded (`apt-get update`, root caveat); skill notes in diffusers.md / payloads.md | SKILL.md [98–100](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L98-L100) [116–126](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L116-L126) · diffusers.md [74](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L74) [159](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L159) [437–446](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L437-L446) · payloads.md [81](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L81) | | F3b | P1 | Headless OpenCV swap was a separate command after the install line; one agent ran the pipeline import first and hit `libxcb.so.1` | Swap folded into the `uv pip install` command in SKILL.md Variant 1 and, as a declared in-block deviation, in diffusers.md § 3 | SKILL.md [116–126](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L116-L126) · diffusers.md [138–151](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L138-L151) [157](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L157) [159](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L159) | | F4 | P1 | Bare-host prerequisites of the wheel undocumented: OpenMPI, `CUDA_HOME`, CUDA-13 libs via the cu130 index, seeded venv, ffmpeg | Prerequisite lines + comments inside the Route A block (Variant 6 inherits); upstream pip-install page cited in the references | distilled-trt-llm.md [61](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L61) · trt-llm.md [29](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L29) [601–606](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L601-L606) [624–635](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L624-L635) [703–706](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L703-L706) | | F5 | P1 | `TRTLLM_USE_PRECOMPILED=1 pip install -e .` resolves an unpublished `1.3.0rc26+bca6761ab8` wheel; rc26 binaries lack an op the pinned Python needs | Hint deleted; "do not use the shortcut on this checkout" paragraph; one-sentence skill notes in both TRT references | distilled-trt-llm.md [61](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L61) · trt-llm.md [29](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L29) [669](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L669) [674–687](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L674-L687) | | F6 | P1 | No output-verification step; ffprobe/ffmpeg/Pillow absent on the host; the NIM container's ffmpeg cannot demux its own VP9 output | New "Verify the output" section (ffprobe, root-free `av`, PIL; expected smoke facts) + pointers; NIM headless-check note | SKILL.md [41–43](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L41-L43) [454–467](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L454-L467) · diffusers.md [437–446](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L437-L446) [482](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L482) · payloads.md [101](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L101) | | F7 | P1 | Server variants lack a headless start / readiness-poll / teardown recipe; SGLang `/health` 503 while warming undocumented; NIM `docker run -d --rm` destroys the logs | Shared named-container + trtllm-serve patterns (start, poll, logs, teardown) with per-variant pointers; SGLang readiness documented; NIM `--rm` dropped (recorded deviation); Nano/Super t2i request body stated in Variant 5 | SKILL.md [230–231](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L230-L231) [274–279](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L274-L279) [319–321](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L319-L321) [372–374](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L372-L374) [401](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L401) [451–452](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L451-L452) · payloads.md [216–217](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L216-L217) · sglang.md [21](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L21) · skill-notes.md [58–101](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L58-L101) · trt-llm.md [43](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L43) [733](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L733) | | F7b | P2 | Servers started in a backgrounded subshell died with the shell; SIGINT to the process group did not stop a server; a second server was started while the first still held the GPU | Headless pattern: launch from a script with `setsid … &`, SIGINT → SIGTERM → SIGKILL escalation, leftover check by PID; never start a second server on a busy GPU (the launch script enforces it) | SKILL.md [372–377](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L372-L377) · distilled-trt-llm.md [465–474](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L465-L474) · skill-notes.md [75–94](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L75-L94) | | F8 | P1 | Distilled 4-Step students are ~122 GiB bf16, not "32B / single GPU": the 1-GPU launch OOMs on 80 GB; the verified `cpu_offload_config` route was undocumented | Model-table note + Variant 6 offload block (measured) + warning that FP8 variants are unverified; same in distilled-trt-llm.md | SKILL.md [79–84](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L79-L84) [339–343](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L339-L343) · distilled-trt-llm.md [22](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L22) [35](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L35) [84–99](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L84-L99) [101](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L101) [103](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L103) [366–370](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L366-L370) [431–439](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L431-L439) [443–447](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L443-L447) · skill-notes.md [101](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L101) | | F8b | P1 | Distilled launch still OOM-prone in practice: agents ran the notebook's plain bf16 launch first (OOM on 80–94 GB GPUs, and a second launch then OOMed against the still-loading server); on 125 GiB-RAM hosts the offload route is OOM-killed | Variant 6 is one gated launch script: GPU memory → plain route only at ≥ 128,000 MiB; host RAM (incl. cgroup ceiling) → bf16 + `cpu_offload_config` at ≥ 128 GiB, else the Hugging Face `fp8` branch with the `embed_tokens` ignore-list patch (eval-verified); refuses to start on a busy GPU; one `setsid trtllm-serve` + `/health` poll with a 1800 s deadline | SKILL.md [345–348](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L345-L348) [372–377](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L372-L377) · distilled-trt-llm.md [63](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L63) [339–416](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L339-L416) | | F9 | P1 | SGLang `docker run` passes no `-e HF_TOKEN` and omits `SGLANG_DISABLE_COSMOS3_GUARDRAILS=1`; the server exits with GatedRepoError 401 | Guardrail-table row fixed; `-e SGLANG_DISABLE_COSMOS3_GUARDRAILS=1 -e HF_TOKEN` in every launch block; request body `guardrails: false` | SKILL.md [249–254](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L249-L254) [262–263](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L262-L263) [284](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L284) [291](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L291) · payloads.md [67](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/payloads.md#L67) · sglang.md [23](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L23) [35](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L35) [41–42](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L41-L42) [80](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L80) [371](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/sglang.md#L371) · skill-notes.md [42–49](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L42-L49) [53–57](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L53-L57) | | F9b | P1 | vLLM-Omni `docker run` blocks passed no `-e HF_TOKEN`: on a fresh node with a cold Hugging Face cache the first launch crashed with HTTP 429 during the anonymous model lookup | Superseded by the notebook's final version (#329), which passes `-e HF_TOKEN` in every `vllm serve` launch; the skill carries that text 1:1 (vllm-omni.md § 2, SKILL.md Variant 3) and `vllm-omni.md` § 7.1 records why the token matters — export `HF_TOKEN` before the launch | SKILL.md [213](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L213) · vllm-omni.md [602–608](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/vllm-omni.md#L602-L608) | | F10 | P1 | NIM profile discovery/pinning (`list-model-profiles`, `NIM_MODEL_PROFILE`, `/v1/manifest`) and guardrail env switches missing from the launch block | profile preflight and `/v1/metadata` check in the Variant 7 launch; env lines in both launch blocks; `/v1/manifest` + `selectedModelProfileId` in the inspect lists | SKILL.md [391–397](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L391-L397) [407–408](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L407-L408) [417–418](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L417-L418) [423](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L423) | | F11 | P1 | NIM cache bind mount not writable by uid 1000; the client-side `chmod -R 777` never reaches a daemon-created mount | Cache preflight in the Variant 7 launch: the write test as the NIM user (uid 1000) runs first; the ownership repair (`docker run --user 0 … chown 1000:1000`) runs only for an empty cache this run created or with `NIM_CACHE_REPAIR=1`, otherwise the launch stops with guidance (review follow-up, see below) | SKILL.md [395–396](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L395-L396) [409–411](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L409-L411) · skill-notes.md [102–108](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L102-L108) | | F12 | P1 | rc26 returns HTTP 500 on `/v1/images/generations`; `/health` 200 does not exercise the image route | rc27 pinned with the reason inside Route A; "a 200 on /health does not exercise the image route" sentence; skill note at trt-llm.md § 2 | trt-llm.md [70](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L70) [564](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L564) [612–620](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L612-L620) [636–637](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L636-L637) [737–740](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L737-L740) | | F13 | P2 | Model table had no measured memory figures, no small-GPU path | Measured paragraph under the table (Edge/Nano, labelled as eval measurements) + fp8 pointer; Nano YAML note in Variant 5 / trt-llm.md | skill-notes.md [26–38](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L26-L38) · trt-llm.md [43](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L43) [722–733](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L722-L733) | | F14 | P2 | Variant 6 returns a one-frame MP4/AVI, the eval asks for a PNG | `ffmpeg -frames:v 1` extraction documented in Variant 6 and distilled-trt-llm.md | SKILL.md [358–361](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L358-L361) · distilled-trt-llm.md [267](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L267) [277–286](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L277-L286) | | F14b | P2 | On the fp8 server the one-frame `/v1/videos/generations` returned HTTP 500 after a successful denoise | Documented fallback: `/v1/images/generations` with `output_type: "image"` (explicit body; needs rc27), recorded in result_summary.md | SKILL.md [361](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L361) · distilled-trt-llm.md [279](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L279) [451–461](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/distilled-trt-llm.md#L451-L461) | | F15 | P2 | Wheel path only needs `examples/visual_gen/configs/*.yaml`, yet the block prescribed full clone + submodules + LFS | Direct SHA fetch (`git fetch --depth 1 origin <sha>`), LFS skipped; shallow-clone warning; Edge needs no checkout | trt-llm.md [636–642](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L636-L642) [647–652](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L647-L652) [703–706](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L703-L706) | | F16 | P2 | `pip install cosmos_guardrail==0.3.0` unconditional although guardrails are disabled; unresolvable on 1.2.1 | Moved to an optional "only if you keep guardrails on" step quoting the setup guide's current pin, `cosmos_guardrail==0.3.2` (its former NLTK data step is gone, #332), with the transformers>=5 caveat | trt-llm.md [669](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L669) [691–699](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L691-L699) | | F17 | P2 | SKILL.md said the NIM "takes plain-text prompts"; `/v1/infer` accepted the compact-JSON assets | Reworded intro + compact-JSON rule; Variant 7 request guidance; the Variant 7 request block | SKILL.md [428–429](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L428-L429) [436–439](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/SKILL.md#L436-L439) · skill-notes.md [8–10](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L8-L10) [13–15](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L13-L15) | | F18 | P2 | Variant 1 had no runnable Edge t2i/t2v snippet, no cwd comment, benign load warnings undocumented | Edge block composed from the README sentence and the notebook branches; cwd comment; two measured bullets | diffusers.md [465](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L465) [486–517](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/diffusers.md#L486-L517) · skill-notes.md [122–130](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/skill-notes.md#L122-L130) | | F2d | P1 | Variant 5 Route A: `uv pip install` run in a later shell call than the venv activation landed the wheel set in whichever Python was first on PATH (eval: the evaluator's own venv, where `llist` has no wheel and the source build wanted `clang`) | The § 7.2 install block and its preflights name the venv explicitly: `uv pip install --python "$TRTLLM_VENV/bin/python"`, `"$TRTLLM_VENV/bin/python" -c …`, `"$TRTLLM_VENV/bin/trtllm-serve"` (the F2c mechanism applied to the TensorRT-LLM launch; added after the validation run) | trt-llm.md [608–611](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L608-L611) [621](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L621) [628](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L628) [634–635](https://github.com/NVIDIA/cosmos-framework/blob/55f0f0f/.agents/skills/cosmos3-generate-media/references/trt-llm.md#L634-L635) | ### Review follow-ups (2026-10-29) Three adjustments after the review, all in one commit (`ddb28a2`), no eval re-run: (1) the fp8 route of `distilled-trt-llm.md` § 7.2 no longer deletes anything — the overlay is a fresh `mktemp -d` directory, and a caller-set `FP8_DST` must not exist yet and must not be `FP8_SRC` or a path inside it; (2) the Variant 7 cache preflight tests write access as the NIM user first and repairs ownership only for an empty cache this run created or with `NIM_CACHE_REPAIR=1`, otherwise it fails with guidance (the host-side recursive `chmod` is gone too); (3) `diffusers.md` § 8.4 is a shared setup block plus one block per mode, and Variant 1 asks for the setup block plus only the requested mode's block. ### Validation **Baseline (first commit `b7ad087`)** — [run 40660687591](https://github.com/NVIDIA/cosmos-framework/actions/runs/40660687591), [dashboard group ci-pr327-b7ad087](http://internal-cosmos-skills-eval.nvidia.com/skills/cosmos3-generate-media/groups/ci-pr327-b7ad087/): **44/44 PASS** (44/44 first-attempt, 0 FAIL, 0 no report, 0 errors; static assessment 100/100) **Baseline vs #324** ([compare](http://internal-cosmos-skills-eval.nvidia.com/skills/cosmos3-generate-media/compare?a=group%3Aci-pr324-b50b766&b=group%3Aci-pr327-b7ad087); the [branch compare](http://internal-cosmos-skills-eval.nvidia.com/skills/cosmos3-generate-media/compare?a=branch%3Askills%2Fgenerate-media-migration-and-eval-public&b=branch%3Askills%2Fgenerate-media-fixes-public) always shows the newest result per cell of each branch): **A** `group:ci-pr324-b50b766`: 42/44 PASS, 14 first-attempt · **B** `group:ci-pr327-b7ad087`: 44/44 PASS, 44 first-attempt · improved 2, regressed 0 | Case | Metric | claude | codex | cursor | opencode | |---|---|---|---|---|---| | `diffusers-edge-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ❌→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `diffusers-edge-t2v` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ❌→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `diffusers-nano-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ✅→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `distilled-trtllm-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ❌→✅ | | | First time success | ❌→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `framework-edge-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ❌→✅ | ✅→✅ | ❌→✅ | ❌→✅ | | `framework-nano-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ❌→✅ | ✅→✅ | ❌→✅ | ✅→✅ | | `nim-generator-i2v` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ✅→✅ | ✅→✅ | ✅→✅ | ❌→✅ | | `sglang-edge-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ✅→✅ | ❌→✅ | ❌→✅ | ✅→✅ | | `trtllm-edge-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ❌→✅ | | | First time success | ❌→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `trtllm-nano-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ✅→✅ | ❌→✅ | ❌→✅ | ❌→✅ | | `vllm-omni-edge-t2i` | Completion | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | | | First time success | ✅→✅ | ✅→✅ | ✅→✅ | ✅→✅ | Completion: overall verdict before → after (✅ PASS, ❌ FAIL). First time success: passed on the first attempt, without a self-correction, before → after. **Added after the validation run:** F2d (`bad39b1`); four relative-link path corrections in `references/` (`../cookbooks/…` → `../../cookbooks/…`); and, merged from #324, the vLLM-Omni notebook's final version (#329: `$PWD` mounts, `-e HF_TOKEN`, the FP8 "Quantized Checkpoints" section in `vllm-omni.md` § 2 and SKILL.md Variant 3; the FP8 pointer in `payloads.md` § 1) — validated locally with the four vllm-omni-edge-t2i cells on the base branch, 4/4 PASS first attempt. `git diff b7ad087 55f0f0f -- .agents/skills/cosmos3-generate-media` shows exactly these. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Signed-off-by: Christina Wang <christwang@nvidia.com> Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
…t broke "The audiovisual [the cosmos3-generate-media framework reference] contains …" now reads "The audiovisual generation skill's [Cosmos Framework reference] contains …" (the published four-step T2I/I2V inference examples moved there with run_with_cosmos_framework.ipynb). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Christina Wang <christwang@nvidia.com>
…kill run_with_vllm_omni.ipynb is removed by this PR; its Quantized Checkpoints section now lives in cosmos3-generate-media/references/vllm-omni.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
lfengad
left a comment
There was a problem hiding this comment.
Checks are green and the skill content I spot-checked matches the tree: cosmos_framework.scripts.inference, the parallelism flags, the -4Step checkpoints, and the sibling skills it links to. The workflow trigger model looks right. There is no pull_request_target, a write-role gate runs before any checkout, forks are refused twice, every checkout uses persist-credentials: false, and GH_TOKEN is dropped before the agent containers start.
One broken link: .agents/skills/cookbooks/cosmos3/quantization/README.md:220 pointed at generator/audiovisual/run_with_vllm_omni.ipynb, which this PR deletes. It came in with the merge of #329. I pushed ae910f7, which points it at cosmos3-generate-media/references/vllm-omni.md#quantized-checkpoints.
Please look at these before merge:
- Internal dashboard links in public bot comments. The skill-eval bot comments on this PR carry many links to an internal
*.nvidia.comdashboard. The URL itself stays out of the tree, but the workflow publishes it on a public PR. Consider posting it only to the job summary or an internal channel. - Review threads. Three of my threads are still unresolved. If the
run_matrix.pyones are done in f8041fe, please resolve them. Fortools/docs/nav.yml:41, NVIDIA/cosmos#390 has to merge right after this PR, or the public COOKBOOK.md link stays broken.
Nits:
- The workflow uses
actions/*@v4, while the rest of the repo is oncheckout@v6,setup-python@v6andupload-artifact@v7. - The skill-authoring guide and
skill_eval/README.mddescribe internal-only infrastructure: lease hosts, the evaluator runbook,~/run-case.sh. Outside contributors can't follow those parts, so a sentence saying so would help.
…(after cosmos-framework #324) (#390) ## Summary The Cosmos3 audiovisual generation notebooks and their README move from `cookbooks/cosmos3/generator/audiovisual/` into the agent skill `cosmos3-generate-media` in [NVIDIA/cosmos-framework#324](NVIDIA/cosmos-framework#324) (the notebooks migrated 1:1 into the skill's `references/`, the README's quickstarts into `SKILL.md`). The short links in this repository that pointed into that directory now resolve to the skill; link texts are unchanged. | Short link | Replaces | Resolves to | |---|---|---| | `nvda.ws/4zd0fw5` | `4z3OmbC` (audiovisual README), `4dTtwTY` (the directory) | `.agents/skills/cosmos3-generate-media/SKILL.md` | | `nvda.ws/48tob2l` | `4zM83ov` (`run_with_vllm_omni.ipynb`) | `SKILL.md`, section "Variant 3 — vLLM-Omni" | Changed here: `COOKBOOK.md` (the `[gen]` definition), `README.md` (the two demo captions, the "every other backend" sentence) and the four generator benchmark pages. **Do not merge before NVIDIA/cosmos-framework#324:** the new targets do not exist on `main` yet, so both short links return 404 until that PR is merged. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Signed-off-by: Christina Wang <christwang@nvidia.com> Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Includes the eval-derived fixes PR #327, merged into this branch on 2026-10-29 (
e1a3ff1): the migration and the fixes that take the eval matrix from 42/44 to 44/44 first-attempt PASS go tomaintogether. Everything is applied as a diff on top ofmain, not as a copy.First cookbook→skill migration (cosmos3-generate-media), the cosmos3-skill-authoring guide, and an opt-in skill-eval CI on self-hosted H100 runners. No eval (GPU) job runs on push or merge.
What this PR delivers
assets/.references/(one file per backend pluspayloads.mdfor shared content). A format change only: Jupyter plumbing removed, nothing corrected or rewritten;references/vllm-omni.mdfollows the vLLM-Omni notebook's last version onmain(Add Cosmos3 FP8 quantization cookbooks and serving examples #329: launch mounts,HF_TOKEN, the FP8 "Quantized Checkpoints" section), since that notebook changed after the migration's pin and before its retirement here; the six notebooks and the audiovisual cookbook README are retired from.agents/skills/cookbooks/(links in the cookbook READMEs and the docs site now point at the skill). Known gap: the video-to-video input clip (an LFS object) is not vendored.run_with_nim.ipynbwas already retired in this repository by docs(cosmos3/nim): update Cosmos3 NIM cookbook to 2.1.0 #296 in favour of.agents/skills/cookbooks/cosmos3/nim/, so the skill carries noreferences/nim.mdcopy of it: Variant 7 delegates to that cookbook and itscosmos3-nim-userskill (pointers, the README's 2.1.0 launch, the readiness and selection checks ofdeployment.md, and theexamples/i2v.pyrequest built from the bundled assets). Record:docs/cookbook_to_skill_migration.md.COSMOS3_UV_GROUP/COSMOS3_UV_ENVas the notebook does; the live CI comment uses a sequence guard and per-cell ledger lines).eval/eval.configis unchanged, so before and after are measured on the same prompts (tables below).main. Known wording leftover ineval/eval.config: the NIM case says the Generator NIM serves text-to-video and image-to-video only, which was true of the retired 1.0.0 NIM; the pinned 2.1.0 NIM also serves text-to-image and video-to-video. The case exercises image-to-video, so results are unaffected; the sentence is corrected in the nexteval.configrevision together with a re-run (the file is frozen here so the migration head and the fixes are measured on the same prompts)..github/workflows/skill-eval.ymland the orchestrator in.github/scripts/skill_eval/run a PR's skills on self-hosted H100 runners — one job per case × agent, one live PR comment that always shows the newest result per cell, dashboard groups per skill version, the inference key from a repository secret, a GitHub-hosted job for the orchestrator's unit tests, and a GitHub-hosted gate that admits only repository members with the write, maintain or admin role (details below).references/running-the-eval.md).Evaluation results
Migration head
b50b766(before the fixes)Head
b50b766, 11 cases × 4 agents (claude = Claude Opus 5.5, codex = GPT-6 Astra, cursor = Claude Sonnet 5.5, opencode = Kimi K2.6), run 40639480322 on the four self-hosted H100 runners, dashboard group ci-pr324-b50b766:42/44 PASS (14/44 first-attempt, 2 FAIL, 0 no report, 0 errors; static assessment 100/100)
diffusers-edge-t2idiffusers-edge-t2vdiffusers-nano-t2idistilled-trtllm-t2iframework-edge-t2iframework-nano-t2inim-generator-i2vsglang-edge-t2itrtllm-edge-t2itrtllm-nano-t2ivllm-omni-edge-t2iTokens (all cells): 154.42M. ↻ = passed after self-correction.
The two FAILs are the opencode agent on the two TensorRT-LLM wheel cases — the documentation gap (no notebook or README says how to obtain a TensorRT-LLM build with Cosmos3 VisualGen) that the fixes below close; nothing the agents self-corrected was changed by the migration itself.
After the fixes (
b7ad087, the #327 head at validation)Baseline (first commit
b7ad087) — run 40660687591, dashboard group ci-pr327-b7ad087:44/44 PASS (44/44 first-attempt, 0 FAIL, 0 no report, 0 errors; static assessment 100/100)
Baseline vs #324 (compare; the branch compare always shows the newest result per cell of each branch):
A
group:ci-pr324-b50b766: 42/44 PASS, 14 first-attempt · Bgroup:ci-pr327-b7ad087: 44/44 PASS, 44 first-attempt · improved 2, regressed 0diffusers-edge-t2idiffusers-edge-t2vdiffusers-nano-t2idistilled-trtllm-t2iframework-edge-t2iframework-nano-t2inim-generator-i2vsglang-edge-t2itrtllm-edge-t2itrtllm-nano-t2ivllm-omni-edge-t2iCompletion: overall verdict before → after (✅ PASS, ❌ FAIL). First time success: passed on the first attempt, without a self-correction, before → after.
Added after the validation run: F2d (
bad39b1); four relative-link path corrections inreferences/(../cookbooks/…→../../cookbooks/…); and the vLLM-Omni notebook's final version (#329:$PWDmounts,-e HF_TOKEN, the FP8 "Quantized Checkpoints" section invllm-omni.md§ 2 and SKILL.md Variant 3; the FP8 pointer inpayloads.md§ 1) — validated locally with the four vllm-omni-edge-t2i cells, 4/4 PASS on the first attempt twice (after the port and after the merge of the fixes).git diff b7ad087 e1a3ff1 -- .agents/skills/cosmos3-generate-mediashows exactly these, plus the review follow-ups below.Eval-derived fixes (merged from #327)
Where =
file:linesate1a3ff1(permalinks;SKILL.md=.agents/skills/cosmos3-generate-media/SKILL.md, reference names =references/<name>). Problem → fix, in priority order; F2d was added after the validation run (see Validation).<tag>) plus a deadTRTLLM_USE_PRECOMPILEDhint; no wheel version anywhere, so cursor/opencode pip-installed stable 1.2.x, which lacks VisualGentensorrt_llm==1.3.0rc27+torch==2.13.0+cu130from pypi.nvidia.com/cu130 (uv--index-strategy unsafe-best-match), VisualGen preflight, pinned checkout for YAMLs only; Route B = source build; mirrored as skill notes in trt-llm.md / distilled-trt-llm.mdpyproject.tomlpins uv==0.11.29;uv venv/pip/syncabort with uv 0.13 anduv self updaterefuses--no-config; Variant 2: pinned-uv preflight (side-by-side install oruvx --from 'uv==0.11.29'); one note in "Read this first"; skill notes in diffusers.md, cosmos-framework.md, payloads.mdnvidia-cutlass-dsl==4.8.0.dev0without--prerelease=allow, which then pulls mpmath 1.5.0a1--no-configfor Variants 1/5/6; 0.11.29 only foruv sync)exportandsource …/activateof the first call were gone in the second, souv pip installwent into the evaluator's own venv and the import check ran against the wrong interpreter (then a needless OpenCV downgrade: the same block passed first-attempt in the other eleven diffusers cells of that run)uv pipcommands of the Variant 1 block and of diffusers.md § 3 carry--python "$COSMOS3_DIFFUSERS_VENV"(declared in-block addition; with the variable unset uv stops instead of installing elsewhere), the import check and the generation snippets run with"$COSMOS3_DIFFUSERS_VENV/bin/python", and the block says it is one shell callcosmos_guardrailpulls GUI opencv; the pipeline imports it even with the safety checker offapt-get update, root caveat); skill notes in diffusers.md / payloads.mdlibxcb.so.1uv pip installcommand in SKILL.md Variant 1 and, as a declared in-block deviation, in diffusers.md § 3CUDA_HOME, CUDA-13 libs via the cu130 index, seeded venv, ffmpegTRTLLM_USE_PRECOMPILED=1 pip install -e .resolves an unpublished1.3.0rc26+bca6761ab8wheel; rc26 binaries lack an op the pinned Python needsav, PIL; expected smoke facts) + pointers; NIM headless-check note/health503 while warming undocumented; NIMdocker run -d --rmdestroys the logs--rmdropped (recorded deviation); Nano/Super t2i request body stated in Variant 5setsid … &, SIGINT → SIGTERM → SIGKILL escalation, leftover check by PID; never start a second server on a busy GPU (the launch script enforces it)cpu_offload_configroute was undocumentedcpu_offload_configat ≥ 128 GiB, else the Hugging Facefp8branch with theembed_tokensignore-list patch (eval-verified); refuses to start on a busy GPU; onesetsid trtllm-serve+/healthpoll with a 1800 s deadlinedocker runpasses no-e HF_TOKENand omitsSGLANG_DISABLE_COSMOS3_GUARDRAILS=1; the server exits with GatedRepoError 401-e SGLANG_DISABLE_COSMOS3_GUARDRAILS=1 -e HF_TOKENin every launch block; request bodyguardrails: falsedocker runblocks passed no-e HF_TOKEN: on a fresh node with a cold Hugging Face cache the first launch crashed with HTTP 429 during the anonymous model lookup-e HF_TOKENin everyvllm servelaunch; the skill carries that text 1:1 (vllm-omni.md § 2, SKILL.md Variant 3) andvllm-omni.md§ 7.1 records why the token matters — exportHF_TOKENbefore the launchlist-model-profiles,NIM_MODEL_PROFILE,/v1/manifest) and guardrail env switches missing from the launch block/v1/metadatacheck in the Variant 7 launch; env lines in both launch blocks;/v1/manifest+selectedModelProfileIdin the inspect listschmod -R 777never reaches a daemon-created mountdocker run --user 0 … chown 1000:1000) runs only for an empty cache this run created or withNIM_CACHE_REPAIR=1, otherwise the launch stops with guidance (review follow-up, see below)/v1/images/generations;/health200 does not exercise the image routeffmpeg -frames:v 1extraction documented in Variant 6 and distilled-trt-llm.md/v1/videos/generationsreturned HTTP 500 after a successful denoise/v1/images/generationswithoutput_type: "image"(explicit body; needs rc27), recorded in result_summary.mdexamples/visual_gen/configs/*.yaml, yet the block prescribed full clone + submodules + LFSgit fetch --depth 1 origin <sha>), LFS skipped; shallow-clone warning; Edge needs no checkoutpip install cosmos_guardrail==0.3.0unconditional although guardrails are disabled; unresolvable on 1.2.1cosmos_guardrail==0.3.2(its former NLTK data step is gone, #332), with the transformers>=5 caveat/v1/inferaccepted the compact-JSON assetsuv pip installrun in a later shell call than the venv activation landed the wheel set in whichever Python was first on PATH (eval: the evaluator's own venv, wherellisthas no wheel and the source build wantedclang)uv pip install --python "$TRTLLM_VENV/bin/python","$TRTLLM_VENV/bin/python" -c …,"$TRTLLM_VENV/bin/trtllm-serve"(the F2c mechanism applied to the TensorRT-LLM launch; added after the validation run)Review follow-ups (2026-10-29)
Three adjustments after the review, all in one commit (
ddb28a2), no eval re-run: (1) the fp8 route ofdistilled-trt-llm.md§ 7.2 no longer deletes anything — the overlay is a freshmktemp -ddirectory, and a caller-setFP8_DSTmust not exist yet and must not beFP8_SRCor a path inside it; (2) the Variant 7 cache preflight tests write access as the NIM user first and repairs ownership only for an empty cache this run created or withNIM_CACHE_REPAIR=1, otherwise it fails with guidance (the host-side recursivechmodis gone too); (3)diffusers.md§ 8.4 is a shared setup block plus one block per mode, and Variant 1 asks for the setup block plus only the requested mode's block. A later commit (55f0f0f) follows the setup guide's move tocosmos_guardrail==0.3.2(trt-llm.md § 7.6; its former NLTK step is gone), notes in § 7.1 that the guide now pins TensorRT-LLMcc63e66while the skill's validated routes stay atbca6761/ 1.3.0rc27, and points Variant 3 at the FP8 "Quantized Checkpoints" section.Skill-eval CI (opt-in; every
.githubchange lives on this branch)gatejob first (no checkout). It reads the role of the person who commented, applied the label or dispatched from the collaborators API and acceptswrite,maintainoradminonly — organisation membership, a read/triage role or a PR from a fork is refused before any self-hosted runner is used (planrefuses fork heads a second time)./run-skill-eval [args]on the PR (reads the workflow copy onmain, so it works after this PR merges), apply one of the labelsrun-skill-eval/run-skill-eval-smoke/run-skill-eval-failed/run-skill-eval-force(works before the merge — the PR's own workflow copy runs; the label is removed again at the end), or dispatch manually:gh workflow run skill-eval.yml --ref <branch> -f pr_number=<N> -f scope=full -f args='…'. Args:force,rerun-failed,smoke-only(aliassmoke),with-smoke,cells=<agent>/<case>,…,group=<id>. Never per-commit.eval/eval.config, one job per case × agent over the idle H100 runners; the CPU canary only on request. One live PR comment per head commit that always shows the newest result per cell (re-runs of the same commit update it; a new commit gets a new comment that lists the PR's earlier runs), plus the dashboard; results are informational.cursor_modelin.github/skill-eval.yml) so the four backends exercise four model families.cosmos-skill-eval+h100; thegpu/h200runners ofgpu-tests.ymlare not used (disjoint label sets). Deployment values (evaluator image, dashboard URL) are repository variables, the inference key a repository secret..github/scripts/skill_eval/.Authoring-skill revision
Rewritten from the generate-media campaign: a description with trigger boundaries; structure and section order; writing commands that pass on the first attempt; how the evaluator judges; eval.config rules; running the eval and reading the dashboard; the fix loop (a stacked fixes PR, gated by the owner); submitting. Generic by design — the generate-media skill is linked as the worked example. Full runbook in
references/running-the-eval.md.🤖 Generated with Claude Code