image-blast-project

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

image-blast-project

GitHub

创建或检查Image Blast项目，解析slug并运行状态助手初始化目录结构。报告项目详情（源文件、JSON配置等）。若缺image.json则建议执行uncover分析；若无图片提示添加。最后按序推荐plate清理、世界/物体3D生成及音效等下游任务。

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

Trigger Scenarios

用户要求创建新的 Image Blast 项目用户询问当前 Image Blast 项目的状态在使用其他 image-blast 子技能前需要初始化环境用户指定了项目名称或 slug

Install

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

More Options

Non-standard path

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

Use without installing

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

指定 Agent (Claude Code)

npx skills add neilsonnn/image-blaster --skill image-blast-project -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-project",
    "description": "Create, inspect, and manage an IMAGE-BLAST project envelope under worlds\/<slug>. Use before other image-blast skills (image-blast-uncover, image-blast-world, image-blast-3d, etc.) or whenever the user asks about active project state.",
    "allowed-tools": "Read Write Glob Bash(ls *) Bash(node .claude\/scripts\/project\/project-state.mjs *) Bash(node .claude\/scripts\/project\/indexed-path.mjs *) Bash(node .claude\/scripts\/project\/download.mjs *) Bash(node .claude\/scripts\/project\/ensure-local-assets.mjs *) Bash(node .claude\/scripts\/project\/delete.mjs *)",
    "argument-hint": [
        "world-name or description"
    ]
}

Create or inspect an Image Blast project. Input: $ARGUMENTS.

Instructions

Follow the generic file convention in .claude/rules/project.md. Inspect generated directories with ls -a before reading JSON details.

Use generic project tools for local indexed asset path computation, explicit downloads, local asset repair, and deletion. Provider-specific scripts are only for provider generation/polling.

Resolve the project slug:
- If $0 is an existing worlds/<slug> directory or a slug-like name, use it.
- Otherwise derive a lowercase hyphenated slug from $ARGUMENTS.
- If no usable input is provided, ask the user which project/world to use.
Run the project-state helper from the repo root. If input/ contains images or the user asked to use staged input, include --stage-input so files move immediately into stable source paths:

node .claude/scripts/project/project-state.mjs --world "<slug>" --stage-input

The helper creates and validates:

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. /image-blast-uncover 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.

Read the printed project state or worlds/<slug>/project.json.
Report:
- project slug and display name
- source file count
- per-image JSON count
- staged files moved from input/, if any
- whether World Labs output exists
- whether image.json exists
- derived object count
- whether world-level SFX exists
- whether scene.json exists
If source images now exist and image.json is missing, continue directly with the /image-blast-uncover workflow for no-cost image analysis and object directory creation. If no source images exist and the user needs to add images, report the input/ path and ask them to add files there.
Recommend downstream actions only after no-cost setup/analysis is complete, in this order:
- Agent(image-blast-plate) for clean plate/source cleanup after object confirmation, when requested or one-shotting
- Agent(image-blast-world) for static 3D environment world generation
- Agent(image-blast-3d) per object 3D generation
- Agent(image-blast-sfx) for ambient, object-impact, or arbitrary sound effects
- Agent(image-blast-image-edit) for generic standalone prompt-based image editing

Version History

4acb43b Current 2026-07-24 11:45

Metadata

Files: 0
Version: 4acb43b
Hash: 2ac1bdfa
Indexed: 2026-07-24 11:45

image-blast-project