| name | image-blast-project |
| description | Create, inspect, and manage an image-blaster project envelope under worlds/<slug>. Use before other image-blast skills or whenever the user asks about project state. |
image-blast-project
Use this skill to create or inspect a world project without starting paid
generation.
Instructions
-
Resolve the project slug. If the user provides an existing worlds/<slug>
directory or slug-like name, use it. Otherwise derive a lowercase hyphenated
slug from the request.
-
Inspect generated directories with ls -a before reading JSON.
-
Create or refresh project state with:
node .claude/scripts/project/project-state.mjs --world "<slug>" --stage-input
The helper creates and validates this envelope:
worlds/<slug>/
project.json
scene.json
image.json
source/
<image-name>.json
output/
world/
sfx/
<object-slug>/
Only minimal project.json and directories are created automatically. The
image-blast-uncover skill writes per-image source/<image-name>.json
and root image.json, then waits for user confirmation before writing
per-object output/<object-slug>/object.json files.
-
Report the printed state:
- project slug and display name
- moved files from
input/
- source image count
- source analysis count
- whether
image.json exists
- object counts
- whether world output exists
- whether SFX exists
- whether
scene.json exists
-
If source images exist and image.json is missing, continue with the
image-blast-uncover skill. If there are no source images, report the
absolute input/ path and ask the user to add images.
-
Recommend downstream skills only after no-cost setup/analysis is
complete, in this order:
image-blast-plate for clean plate/source cleanup after object
confirmation, when requested or one-shotting.
image-blast-world for static 3D environment generation.
image-blast-3d for per-object 3D model generation.
image-blast-sfx for ambient, object-impact, or arbitrary sound effects.
image-blast-image-edit for generic standalone prompt-based image edits.
Do not call provider generation scripts from this skill.