QJX-XXXX/game-visual-forge / skills/forge-text-audio
forge-text-audio
VerifiedGenerate, redraw, inpaint, continue, validate, and deliver explicitly requested game sound effects and ambience with a locally installed Stable Audio 3 Small-SFX model and Unity AudioClip integration. Use only when the user explicitly asks for non-speech game audio; do not trigger for visual-only work, dialogue, voice-over, songs, or complete musical scores.
Forge Text Audio
Use this Skill only when the user explicitly requests a game sound effect, UI sound, action sound, ambience, or non-verbal creature sound. Do not add audio as a side effect of map, sprite, or video work. Reject dialogue, speech, voice-over, songs, and complete musical scores instead of silently selecting another provider.
Workflow
For Python interpreter/package issues, use the Python environment guide. Report the actual environment and offer precise manual steps or authorized Agent help. This permits scoped Python setup after user authorization; it does not replace Stable Audio's runtime/model installation flow or personal license acceptance.
- Group intake questions into sound, mode/source, and delivery. Ask for one consolidated request confirmation. Support exactly
text-to-audio,redraw,inpaint, andcontinue. - Preserve the user's original request and create an English Stable Audio prompt package. Use three candidates for text generation and redraw, and one candidate for inpainting and continuation unless the confirmed request overrides the count.
- Run the local-only provider preflight. The official
stable-audio-3runtime must use an isolated, user-selected directory; the user must accept Stability AI and Gemma terms personally, makestabilityai/stable-audio-3-small-sfxavailable in the local Hugging Face cache, and have FFmpeg/FFprobe. If prerequisites are missing, reportneeds_user_actionand offer the repository installation flow or scoped Python assistance. Never install or download without setup authorization. When setup is already authorized, help within that scope using the relevant guide. Never accept licenses for the user or call a hosted API during this local-only workflow. - Run the provider through
scripts/providers/stable_audio.pyusing the shared binary UTF-8 JSON protocol and the repository-localgame-visual-forge.local.jsonruntime configuration. UTF-8 is mandatory for every subprocess even when the generated prompt is English because paths, original requests, logs, and Unity names may be non-ASCII. - Decode provider latents without the official API's destructive output clamp. Before writing a raw candidate, record the decoded peak and overrange count and apply only enough global attenuation to keep the peak at or below -1.0 dBFS; never boost quiet audio. Keep written raw candidates and source audio immutable. Process into a separate staging directory, validate 44,100 Hz, 16-bit signed PCM WAV delivery, and record SHA-256 hashes, waveform, spectrum, loop evidence, and protected-region evidence.
- Present playable candidates and require the user's final listening approval. Record exactly these checks: prompt/action match; transient/impact clarity; noise/generation artifacts; unwanted speech/music; spatial/channel suitability; loop/tail quality. Do not publish with a failed or missing check.
- If Unity delivery is requested, import the approved
unity-audio-manifest.jsonwith the independent UPM package atintegrations/unity/com.game-visual-forge.audio. The package importsAudioClipassets and does not create or modify scene objects. - Only when the user explicitly requests scene placement, use Unity MCP to create or reuse an
AudioSource, bind the imported clip, apply playback and spatial settings, save the target scene, and verify that unrelated scene roots are unchanged.
Required safeguards
- Never retry a failed or
generation_unknownattempt automatically. - Reject generated one-shots with continuous dense energy and no credible transient-to-tail decay as
dense-noise; do not present them for listening approval. - Never treat a local WAV as proof that Unity import or scene placement succeeded.
- Publish WAV only: 44,100 Hz, 16-bit signed PCM, mono or stereo as confirmed. Do not publish MP3, OGG, FLAC, AIFF, or an upsampled 48 kHz copy.
- Use the repository command surface through
scripts/run.py; do not duplicate business logic in this Skill launcher.
Read stable-audio-workflow.md for the provider protocol and processing-and-quality.md for deterministic processing and review gates.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |