Skip to content
OpenSmartRoute
Skillv1.0.0

rfxgen

Generate, convert, preview, and integrate retro game sound effects with raysan5/rfxgen. Use when a user needs coin, laser, explosion, power-up, hit, jump, or blip SFX; wants `.rfx` parameters converte

by akillness(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from akillness/jeo-skills (.agent-skills/rfxgen/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill rfxgen. Copyright stays with the author.

rFXGen

When to use this skill

  • Generate compact retro/chiptune sound effects from named presets.
  • Tune and save .rfx parameter files in the desktop UI.
  • Convert .rfx into .wav, .qoa, .raw, or C header data.
  • Batch sound generation or diagnose an rFXGen source build.

Route coding-agent notification packs to game-sounds. Route runtime event architecture and engine playback integration to an engine-specific audio skill after assets are generated.

Instructions

Step 1: Define the asset contract

Capture the gameplay event, preset family, output format, sample rate, sample size, channel count, duration/style constraints, loop behavior, naming, and runtime target. Start with one representative sound before generating a full kit.

Supported upstream generation presets at the inspected revision are:

coin laser explosion powerup hit jump blip

Supported format values are sample rates 22050|44100, sample sizes 8|16|32, and channels 1|2.

Step 2: Prefer an existing binary or online tool

bash .agent-skills/rfxgen/scripts/setup.sh --check

Use the official WebAssembly tool for quick interactive design when local installation is unnecessary. Build from source only when a reproducible CLI or code change is required.

bash .agent-skills/rfxgen/scripts/setup.sh --clone
bash .agent-skills/rfxgen/scripts/setup.sh --build

The upstream CMake project fetches raylib when it is not already available, so a build may require network access and platform development libraries.

Step 3: Generate through the validated wrapper

bash .agent-skills/rfxgen/scripts/generate.sh \
  --preset explosion --output assets/sfx/explosion.wav \
  --format 44100,16,1

The wrapper validates preset, extension, and format before invoking rfxgen. Set RFXGEN_BIN when the binary is not on PATH.

Step 4: Convert or export deliberately

The native CLI accepts .rfx and supported audio input with --input, and output in .wav, .qoa, .raw, or .h. Keep .rfx alongside exported audio when future tuning matters. Use .h only when embedding bytes is appropriate for the target build; otherwise prefer an external asset pipeline.

Step 5: Integrate as an event-driven kit

Name assets by abstract game event, not by implementation callsite. Keep loudness and frequency ranges distinct enough for rapid recognition. Test common overlap cases, repeated triggers, pause/resume, and low-volume playback.

Step 6: Verify observable output

For every generated asset:

  • confirm the file exists and is non-empty;
  • inspect sample rate, bit depth, and channels with ffprobe or equivalent;
  • audition on target hardware;
  • confirm no clipping and no unintended long tail;
  • verify the game event triggers the right semantic sound;
  • preserve attribution/license information when distributing source or modified rFXGen code.

Examples

Generate a mono jump sound

bash .agent-skills/rfxgen/scripts/generate.sh \
  --preset jump --output jump.wav --format 22050,16,1

Convert tuned parameters

rfxgen --input tuned-hit.rfx --output tuned-hit.wav --format 44100,16,1

Best practices

  1. Design one sound per semantic gameplay event.
  2. Preserve .rfx sources for iteration.
  3. Use mono unless stereo carries intentional information.
  4. Audition repeated and overlapping playback, not just isolated files.
  5. Pin source builds and retain the zlib license notice.

References

  • references/cli-and-build.md — CLI matrix, build notes, and verification checklist.
  • references/upstream.md — inspected revision and license.
  • rFXGen
  • Official WebAssembly tool

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-rfxgen/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-rfxgen.ocm.jsonjson
{
  "ocm": "1",
  "id": "akillness-jeo-skills-rfxgen",
  "kind": "skill",
  "name": "rfxgen",
  "description": "Generate, convert, preview, and integrate retro game sound effects with raysan5/rfxgen. Use when a user needs coin, laser, explosion, power-up, hit, jump, or blip SFX; wants `.rfx` parameters converted to WAV/raw/C headers; needs batch CLI generation; or must build and troubleshoot rFXGen. Triggers on: rFXGen, rfxgen, sfxr, chiptune SFX, .rfx, procedural game sound, or sound preset.",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "math"
    ],
    "tags": [
      "skill-md",
      "game-development",
      "audio",
      "sound-effects",
      "procedural-audio",
      "raylib",
      "cli",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Generate, convert, preview, and integrate retro game sound effects with raysan5/rfxgen. Use when a user needs coin, laser, explosion, power-up, hit, jump, or blip SFX; wants `.rfx` parameters converted to WAV/raw/C headers; needs batch CLI generation; or must build and troubleshoot rFXGen. Triggers on: rFXGen, rfxgen, sfxr, chiptune SFX, .rfx, procedural game sound, or sound preset."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/rfxgen/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/rfxgen/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/rfxgen/SKILL.md"
    },
    "compatibility": "rFXGen desktop binary, or CMake 3.11+ and a desktop C toolchain for source builds",
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep"
    ]
  },
  "instructions": "# rFXGen\n\n## When to use this skill\n\n- Generate compact retro/chiptune sound effects from named presets.\n- Tune and save `.rfx` parameter files in the desktop UI.\n- Convert `.rfx` into `.wav`, `.qoa`, `.raw`, or C header data.\n- Batch sound generation or diagnose an rFXGen source build.\n\nRoute coding-agent notification packs to `game-sounds`. Route runtime event architecture and engine playback integration to an engine-specific audio skill after assets are generated.\n\n## Instructions\n\n### Step 1: Define the asset contract\n\nCapture the gameplay event, preset family, output format, sample rate, ",
  "cost": {
    "context_tokens": 941
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-rfxgen/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.