OpenParable
Skip to content
← Back to skills

Asset Creator

Design
asset-creator

Asset Creator is an Agent Skill for design published in the HorizonRobotics/EmbodiedGen repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create 3D assets with EmbodiedGen using img3d-cli, text3d-cli, and texture-cli. Use this skill whenever users ask to generate assets from images/text, texture existing meshes, run retry/seed controlled generation, or choose the proper asset-generation CLI from mixed requirements.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/HorizonRobotics/EmbodiedGen/blob/HEAD/embodied_gen/skills/asset-creator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/asset-creator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Assets Creator

Unified entry for three EmbodiedGen asset-generation CLIs: img3d-cli, text3d-cli, and texture-cli.

When To Use

Use this skill when users want to:

  • Generate a 3D asset from one or more input images.
  • Generate 3D assets in batch from text prompts.
  • Generate or edit textures for existing meshes.
  • Get help choosing the correct CLI from mixed asset-generation requirements.

Routing Rules (Core)

  1. img3d-cli: input is image paths (--image_path or --image_root).
  2. text3d-cli: input is text prompts (--prompts) and target is direct asset output.
  3. texture-cli: input is existing mesh path(s) (--mesh_path) plus texture prompt(s) (--prompt).

Pre-checks

  1. Run commands from the repository root.
  2. Confirm the active environment is embodiedgen.
  3. If CLI commands are unavailable, run pip install -e . to register entrypoints.

Standard Command Templates

1) Image to 3D: img3d-cli

img3d-cli --image_path .../sample.jpg --n_retry 1 --output_root outputs/imageto3d

Common parameters:

  • --image_path / --image_root
  • --output_root
  • --n_retry
  • --seed
  • --skip_exists

2) Text to 3D: text3d-cli

text3d-cli \
  --prompts "small bronze figurine of a lion" "A globe with wooden base" \
  --n_image_retry 1 --n_asset_retry 1 --n_pipe_retry 1 \
  --seed_img 0 \
  --output_root outputs/textto3d

Common parameters:

  • --prompts
  • --output_root
  • --asset_names
  • --n_image_retry --n_asset_retry --n_pipe_retry
  • --seed_img --seed_3d

3) Mesh Texture Generation: texture-cli

texture-cli \
  --mesh_path ".../horse.obj" \
  --prompt "A gray horse head with flying mane and brown eyes" \
  --output_root "outputs/texture_gen" \
  --seed 0

Common parameters:

  • --mesh_path (supports multiple inputs)
  • --prompt (must align 1:1 with mesh inputs)
  • --output_root
  • --seed
  • --texture_size
  • --ip_adapt_scale --ip_img_path (optional reference-image control)

Output Conventions

  • img3d-cli: each sample is typically under <output_root>/<sample>/result/.
  • text3d-cli: <output_root>/asset3d/<asset_name>/result/.
  • texture-cli: <output_root>/<mesh_stem>/texture_mesh/.

Failure Handling and Retry

  1. OOM or GPU pressure: reduce batch size and concurrency.
  2. Unstable quality: increase --n_retry or --n_*_retry.
  3. Missing outputs: verify output-root permissions and path spelling; prefer absolute paths.