Agent Skills
› neilsonnn/image-blaster
› image-blast-sfx
image-blast-sfx
GitHub根据项目世界或物体描述生成并后处理音效（环境音、撞击声或自定义），支持循环与静音修剪。
Trigger Scenarios
需要生成游戏或应用的环境音效
需要为特定物体生成撞击音效
需要定制化的声音效果
Install
npx skills add neilsonnn/image-blaster --skill image-blast-sfx -g -y
SKILL.md
Frontmatter
{
"name": "image-blast-sfx",
"agent": "image-blast-sfx",
"context": "fork",
"description": "Generate and post-process a clean sound effect, object impact, or ambient loop.",
"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\/sfx\/fal-elevenlabs-sfx.mjs *)",
"argument-hint": [
"world-name"
]
}
Generate an SFX for project $0.
Instructions
- If
$0is missing, ask for the world slug. - If the SFX target is missing or ambiguous, ask for exactly one request.
- Use
ls -abefore reading generated state. - Choose one mode:
- World ambience: output to
worlds/$0/output/sfx/, use--loop --count 2 --kind world-ambience --prefix ambient-loop --duration-seconds 10. - Object impact: resolve one object, output to
worlds/$0/output/<object-id>/sfx/, use--count 4 --kind object-impact --prefix impact-<object-id> --duration-seconds 1. Do not use--loop. - Custom SFX: use the supplied prompt, output to
worlds/$0/output/sfx/unless an object is clearly specified, use--kind arbitrary.
- World ambience: output to
- Prompt structure:
- Object impact:
impact one-shot, short-decay, <object material description from object.json> hitting a hard surface. - World ambience:
ambient environment, loop of <description of only ambient qualities of scene from image.json>. - Custom SFX: keep it literal, short, and isolated unless the user requested ambience or a loop.
- For non-loop output, the script analyzes each returned file with
ffprobe/ffmpeg, trims leading/trailing silence or low noise, normalizes loudness, and storesaudio_analysisin the hidden request JSON. Loop output is left as raw provider audio so the seamless boundary is preserved.
node .claude/scripts/project/project-state.mjs --world "$0"
Run:
node .claude/scripts/sfx/fal-elevenlabs-sfx.mjs \
--prompt "<sound prompt>" \
--output-dir "<target output dir>" \
--prefix "<safe prefix>" \
--count "<1-4>" \
--kind "<world-ambience|object-impact|arbitrary>" \
--duration-seconds "<optional 0.5-22>" \
--loop "<for world ambience or explicit loop requests>" \
--postprocess true
Add --loop only for world ambience or explicit looping requests. Avoid music or voices unless explicitly requested.
If request metadata records provider URLs but local audio files are missing, fill them from the matching hidden request JSON:
node .claude/scripts/project/ensure-local-assets.mjs --from "<request-json-path>"
Final response: report generated audio files, loop status, request metadata, prompt used, and the trimming/quality notes from audio_analysis.
Version History
- 4acb43b Current 2026-07-24 11:45
