image-blast-world

Agent Skills › neilsonnn/image-blaster › image-blast-world

image-blast-world

GitHub

基于源图像生成3D静态世界环境，支持从图片创建或恢复World Labs项目。通过合成空场景提示词并调用脚本执行生成，自动处理状态检查、资产下载及本地文件校验，确保输出完整的3D资源。

.claude/skills/image-blast-world/SKILL.md neilsonnn/image-blaster

Trigger Scenarios

需要生成3D世界环境从图片创建World Labs项目恢复未完成的3D世界生成任务

Install

npx skills add neilsonnn/image-blaster --skill image-blast-world -g -y

More Options

Non-standard path

npx skills add https://github.com/neilsonnn/image-blaster/tree/main/.claude/skills/image-blast-world -g -y

Use without installing

npx skills use neilsonnn/image-blaster@image-blast-world

指定 Agent (Claude Code)

npx skills add neilsonnn/image-blaster --skill image-blast-world -a claude-code -g -y

安装 repo 全部 skill

npx skills add neilsonnn/image-blaster --all -g -y

预览 repo 内 skill

npx skills add neilsonnn/image-blaster --list

SKILL.md

Frontmatter

{
    "name": "image-blast-world",
    "agent": "image-blast-world",
    "context": "fork",
    "description": "Generate the 3D static environment of a world from a source or plate image.",
    "allowed-tools": "Read Write Glob Bash(ls *) Bash(node .claude\/scripts\/project\/project-state.mjs *) Bash(node .claude\/scripts\/project\/ensure-local-assets.mjs *) Bash(node .claude\/scripts\/world\/generate-world.mjs *)",
    "argument-hint": [
        "world-name"
    ]
}

Create or resume one World Labs world for project $0.

Instructions

If $0 is missing, ask for the world slug.
Use ls -a before reading generated state.
Use an explicit image path or prompt from $ARGUMENTS when provided.
Without an explicit image, the world helper uses the highest-index visible image in worlds/$0/source/.
Before generating, synthesize a prompt for the world that takes the original caption data we have and removes and objects we took out of the image. Use worlds/$0/image.json for the original scene description, then subtract all confirmed or explicitly removed objects from that description. Confirmed objects are worlds/$0/output/<object>/object.json files; use object.name and object.description to understand what to remove from the original scene description.
Treat the synthesized prompt as a text clean plate: preserve the original setting, materials, lighting, atmosphere, camera feel, and spatial layout, but describe the scene as an empty. Do not name, imply, or reintroduce removed objects, and do not reuse imageJson.short_caption directly.
If the user specifically provides caption wording, apply the same subtraction rule before sending it. The World Labs prompt should describe the static empty environment, the "plate" environment, not the objects that were removed.
The helper resumes unfinished .N-world-request.json, strips base64 before writing JSON, polls World Labs, writes N-world.json, and downloads every referenced world asset to matching N-world* files in worlds/$0/output/world/.
The frontend must only load local files from disk. World Labs URLs in N-world.json are provenance/resume data only; never leave .spz, collider .glb, panorama, or thumbnail assets to be loaded from provider URLs.
If any referenced .spz, collider, or panorama URL exists in N-world.json, make sure the matching local file is present before reporting success. Use the generic local asset tool on the matching N-world.json if files are missing.

node .claude/scripts/project/project-state.mjs --world "$0"

Run:

node .claude/scripts/world/generate-world.mjs --world "$0" --prompt "<empty-environment world caption>"

Pass --image only when an explicit image path is provided or the selected source is not the helper default. Always pass --prompt with the synthesized empty-environment caption. For explicit regeneration, append --regenerate.

To fill missing local files from an existing world response, run:

node .claude/scripts/project/ensure-local-assets.mjs --from "worlds/$0/output/world/<N>-world.json"

node .claude/scripts/project/project-state.mjs --world "$0"

Final response: report the source image used when relevant, the generation index, world output path, all downloaded .glb, .spz, panorama, and thumbnail paths if present, and any failure/resume metadata.