Tao Generate Od Defects
NVIDIAOfficialCreated by NVIDIA Corporation
- Skill
- Workflow
- Data and AI
- Apache-2.0
- Medium risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a workflow for generating synthetic object-detection defect images and corresponding COCO-format labels using the AnomalyGenNext 1.1 container. It supports both prepared input plans and native testcase execution. The process includes optional guardrails for content safety and produces validated fine-grained and binary defect annotations. This tool is strictly for synthetic data generation and does not perform model training or integrate outputs directly into training pools.
What it does
- Runs AnomalyGenNext 1.1 inference to create synthetic defect images.
- Generates fine-grained and binary COCO-format labels for detected defects.
- Supports optional guardrails for text screening, image content safety, and face blurring.
- Validates input integrity manifests and checkpoint paths before execution.
- Produces a validation summary and status report for generated datasets.
- Enforces strict container mount requirements for checkpoint and output directories.
When to use it
- When you need to generate synthetic defect data for object detection tasks.
- When you have prepared input data from the tao-prepare-anomalygennext-inputs workflow.
- When you need to create binary or fine-grained COCO labels for anomaly detection.
- When you require a controlled generation environment with optional safety guardrails.
Advantages
- Automates the complex setup and execution of AnomalyGenNext inference.
- Ensures consistent output formatting with validated COCO annotations.
- Provides built-in safety mechanisms to screen generated content.
- Strict validation of inputs and checkpoints prevents common runtime errors.
Usage examples
- “Generate synthetic defects using my prepared input directory.”
- The agent executes the generation script using the specified inputs-dir, base-checkpoint, and checkpoint-root, producing synthetic images and COCO labels in the output directory.
- “Run AnomalyGenNext generation without guardrails.”
- The agent triggers the generation process with the --no-guardrail flag, disabling text screening, image safety, and face blurring, ensuring the requested row count is fully generated.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/nvidia/tao-generate-od-defects/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip tao-generate-od-defects.zip -d .agents/skills
Documentation by NVIDIA Corporation
Generate AnomalyGenNext OD Defects
This leaf uses the upstream generator and pseudo-labeler in the pinned public
container. It does not prepare detector gaps, run AMP, train AnomalyGenNext, or
append outputs to a detector training set.
Read references/execution-contract.md when adapting input or completion
behavior, and references/container-runtime.md before submission.
Inputs
Pass either:
--inputs-dirpointing to the completed output oftao-prepare-anomalygennext-inputs; or--input-data-path,--checkpoint, and matching--recipefor a native AnomalyGenNext testcase.
Also provide the Cosmos3-Nano base checkpoint, the complete AnomalyGenNext checkpoint root, and one or more GPUs. Every testcase image and aligned mask must exist, every anomaly type must occur in the recipe, and the requested row count must match the testcase. When a prepared integrity manifest exists, every recorded hash is verified before generation.
Run
Invoke tao-launch-workflow, review the exact image, mounts, GPU shape, runtime,
and output directory, then submit the generate action:
scripts/generate_od_defects.py \
--inputs-dir /results/prepared_inputs \
--base-checkpoint /models/Cosmos3-Nano \
--checkpoint-root /workspace/paidf-anomalygen/checkpoints \
--output-dir /temporary/generation \
--published-root /persistent/generation \
--no-guardrail \
--num-gpus 1When execution uses temporary storage, --published-root records the
persistent locations that will contain the saved results.
Guardrails are enabled by default and preserve the native invocation without a
guardrail flag. The wrapper appends --no-guardrail only when explicitly
disabled.
--no-guardrail disables text screening, image content-safety screening, and
face blurring together. The checkpoint root is mounted over the image's
canonical /workspace/paidf-anomalygen/checkpoints tree and validated before
GPU work. The Nano tokenizer, Edge processor, and DINOv2 assets are always
required; guardrail-enabled runs additionally require the Qwen3Guard and Cosmos
Guardrail repositories. Generation is forced offline after validation. The
selected platform must honor the declared checkpoint_root.container_path;
the generation leaf rejects a different mount point. The base-checkpoint
argument remains separate: it is the parent containing
checkpoint.json and the model/ checkpoint directory.
Completion
For each dataset, generated + guardrail_blocked must equal requested rows.
With --no-guardrail, generated must equal requested rows and
guardrail_blocked remains zero. The validation summary records the selected
guardrail mode.
The pseudo-label count must match generated images, each image needs an
annotation, categories must be declared anomaly types, and every COCO bbox must
be positive and inside its image. The action emits:
DATASET/raw/
DATASET/pseudo_labels/coco_annotations.json
pseudo_labels/coco_annotations.json
pseudo_labels/coco_annotations_od_defect.json
validation_summary.json
status.jsonThe native COCO preserves TEXTURE+DEFECT categories. The binary file maps all
annotations to defect. Only a calling application may admit these outputs to
training; this leaf always reports training_pool_mutated=false.
Files
- ATTRIBUTION.mdAdded by AutoGineer939 B
- BENCHMARK.md6.9 KiB
- LICENSELicence file added by AutoGineer11.2 KiB
- SKILL.md3.8 KiB
- config/skillspector-baseline.yaml1.4 KiB
- evals/evals.json901 B
- references/container-runtime.md2.9 KiB
- references/execution-contract.md4.5 KiB
- references/skill_info.yaml1.8 KiB
- scripts/generate_od_defects.pyScript15.0 KiB
- scripts/tests/test_generate_od_defects.pyScript10.9 KiB
- skill-card.md4.7 KiB
- skill.oms.sig5.9 KiB
references/container-runtime.md
AnomalyGenNext 1.1 container runtime
Read this before submitting generation.
Resolve the image through references/skill_info.yaml:
nvcr.io/nvidia/paidf-anomalygen:1.1.0The image contains AnomalyGenNext 1.1 and its runtime at
/workspace/paidf-anomalygen. Do not substitute the older 1.0 image and do
not overlay an external checkout or host virtualenv.
Expose the testcase or prepared-input result, task checkpoint and recipe, Cosmos3-Nano base checkpoint, complete checkpoint root, this skill directory, and a new durable output directory. Preserve absolute paths or rewrite all related paths consistently inside the compute frame. The platform owns writable temporary storage and caches.
The image defaults to the non-root anomalygen user with UID 10000. Every
input mount must be readable and traversable by the effective container user;
every output, temporary, and cache mount must be writable. Before starting
Python, use the selected image, mounts, and runtime identity to create and
remove a nested temporary file in each writable mount. Stop on failure and
report the affected host path with its ownership and mode. If the platform
maps the process to the host user instead, that identity must resolve to a
username and all home and cache locations must remain writable. For the local
Docker identity-mapping recipe, see
Running in Docker.
Mount the complete checkpoint root read-only at
/workspace/paidf-anomalygen/checkpoints. The action rejects any other mount
location. It always validates Qwen/Qwen3-VL-8B-Instruct and
nvidia/Cosmos3-Edge in the Hugging Face cache under hf/, plus a
Transformers-compatible facebook/dinov2-large.
The wrapper preserves the native default invocation when guardrails are on and
passes --no-guardrail only when they are explicitly disabled. The flag
disables text screening, image content-safety screening, and face blurring
together. When guardrails are enabled, validation also requires
Qwen/Qwen3Guard-Gen-0.6B and nvidia/Cosmos-Guardrail1; those repositories
are not required with --no-guardrail. It then forces Hugging Face and
Transformers offline. Missing assets fail before sampling. Keep registry and
Hugging Face credentials out of specs, commands, logs, and job records.
Invoke the command declared in skill_info.yaml, for example inside the
container:
python /opt/tao-generate-od-defects/scripts/generate_od_defects.py \
--inputs-dir /inputs/prepared \
--base-checkpoint /models/Cosmos3-Nano \
--checkpoint-root /workspace/paidf-anomalygen/checkpoints \
--output-dir /results/generation \
--no-guardrail \
--num-gpus 1The exposed GPU count must match --num-gpus. The output directory must not
already exist. The base path must contain checkpoint.json and the model/
checkpoint directory; it is not the shared checkpoint root. Read
execution-contract.md for the completion and accounting gates.
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Declares allowed tools, Needs Python
The author says: Requires the AnomalyGenNext 1.1 container, CUDA GPUs, base and task checkpoints.
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
- Scripts that your agent may run
This skill includes scripts that your agent may run. Read them before you use it.
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- NVIDIA Corporation
- Publisher
- NVIDIA (Official)
- Source
- NVIDIA/skills · skills/tao-generate-od-defects · commit fce3cca
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE-APACHE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by NVIDIA Corporation or NVIDIA.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download tao-generate-od-defects.zip