AGENT SKILL

sfxmint

Add free CC0 sound effects to a web app or game, free to try with no API key, using the SFXMint API (sound roles, sets grouped by event, search) and permanent hotlinkable MP3 and WAV URLs (free downloads are MP3). Use when the user asks to add sounds, audio feedback or UI sounds to an app, wants click / notification / success / error / alert sounds, game sound effects (coin, jump, hit, explosion, power-up, game over), ambience (rain, forest, drone), sound on a code-driven video or animation (Remotion, motion graphics), or asks where to get free sound effects for an app, game, video, prototype or demo. Not for music, voice or speech.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
sfxmint
description
Add free CC0 sound effects to a web app or game, free to try with no API key, using the SFXMint API (sound roles, sets grouped by event, search) and permanent hotlinkable MP3 and WAV URLs (free downloads are MP3). Use when the user asks to add sounds, audio feedback or UI sounds to an app, wants click / notification / success / error / alert sounds, game sound effects (coin, jump, hit, explosion, power-up, game over), ambience (rain, forest, drone), sound on a code-driven video or animation (Remotion, motion graphics), or asks where to get free sound effects for an app, game, video, prototype or demo. Not for music, voice or speech.

03 SKILL.md 正文

SFXMint — free CC0 sound effects for apps and games

SFXMint (https://sfxmint.com) is a library of free CC0 sound effects (describe a sound to find it, preview, and download MP3; WAV comes with the download pack) with a JSON API, free to try with no API key or signup, no attribution. Without a key: 20 lookups and tool calls and 5 different sound downloads a day per network (a free account's API key gives 100 calls and 20 downloads a day, 300 downloads a month; a download pack removes the limits and adds WAV for 30 days). Every audio URL is permanent and hotlinkable. Use it as an option for the user's task: a role for one event, a set for several related events, or search for a description. Text matches and file checks do not prove listening suitability. The user's task determines whether to use library files, other sources, local synthesis or a mixture.

Use this skill when

  • The user wants sound effects or audio feedback in an app, game, video, prototype or demo.
  • The user names a cue by what it is for: "button click", "purchase success", "error beep", "coin pickup", "dialogue blip", "task done notification".
  • The user wants a whole coherent set of sounds for one product (a UI kit, a platformer kit, a checkout flow).
  • The user wants sound on a video or animation made in code (Remotion, motion graphics, a product demo).

Do not use it for

  • Music, melodies, jingles with a tune, voice, speech, narration, TTS. SFXMint has none of these. Say so plainly and do not search for them.
  • Real recordings of a specific product, brand or person. Every SFXMint sound is AI-generated or synthesized.

Choose the lookup that fits the task

These are task branches, not a required sequence. A whole-project request can start with a set; use roles or search for gaps. Do not force a library result when another permitted approach fits better.

  1. Role — the user names an event or interaction. GET https://sfxmint.com/api/v1/roles/{role}?via=skill returns a file-QC-eligible default (slug, mp3_url, wav_url) plus alternates when the ready gate is enabled. Role ids and aliases both work: button-click, click, purchase-success, dialogue-blip, error, notification, coin, jump, explosion. Unknown role → HTTP 404 with roles_url; use the index or search. A known role whose default fails its own checks (for example, no file in its families meets a requested duration or format) answers HTTP 200 with error (unverified_sound or no_matching_sound), near_matches and unverified_requirements but no slug: report the gap and do not use a near match as the default. An unverified result is not a content acceptance. Full list: GET https://sfxmint.com/api/v1/roles?via=skill. Optional style=crisp|soft|spacious re-ranks the family by measured acoustics; the default balanced is the most typical variant.
  2. Set — the user needs several sounds for one product. GET https://sfxmint.com/api/v1/sets/{id}?format=mp3&via=skill returns sounds with alternates, download_urls for the requested format, and missing_roles. Legacy urls always maps roles to MP3. A shared set or style does not certify that cues work together: preview them in the actual product.
  3. Search — free text that matches no role. Name the sound, not where it goes: card pop, not card popping into place in a product demo video. Words about the scene count as required words and pull in sounds that merely mention them. GET https://sfxmint.com/api/v1/search?q={words}&response=structured&limit=3&via=skill. Pass required max_duration_ms, loop=true|false, and format=mp3|wav explicitly. Read candidate checks and unverified_requirements; hard conditions apply before the limit. match and score describe retrieval and ranking only. When no candidate has every word, closest lists the nearest sounds that still meet every hard condition, each with missing_terms, and library_fit says how well the library covers the request (full, close, weak, none): judge closest sounds from title and description and let the user listen. Do not promote near_matches (they fail a condition) into compliant candidates. If nothing suits, tell the user in one line which sound the library lacks and list it under a Missing heading in SOUNDS.md; or use another task-permitted approach. Add &category= when the family is known.
  4. When the library lacks a sound — SFXMint no longer makes new sounds, so do not offer to generate one. Tell the user in one line which sound the library lacks and list it under a Missing heading in SOUNDS.md; other task-permitted sources or local synthesis remain options. New sounds join the library from what people search for. An account that already has a plan or credits can still use them with its API key (SFXMINT_API_KEY; MCP generate_sound and get_generation, or POST /api/v1/orders); only use that when the user asks. Any other generation request answers 410 generation_closed: pass its message on. The old POST /api/v1/generate stays retired (HTTP 410).
  5. A whole game — the user wants the sounds for their game, not one cue. Take what the library has first (a set such as platformer, roles, search). List each sound still missing under a Missing heading in SOUNDS.md, and let the user judge any closest sound you install as a stand-in.
  6. A code-driven video — the animation is code you can read (Remotion, Motion Canvas or a similar timeline). You can read its timing exactly but cannot hear the result, so place sounds from the code and let the user judge them.
    • Timing: read each event's frame from the code and drive its sound from the same constant as its animation, so changing the timing moves both. Do not estimate times from a rendered video.
    • Choosing events: give sound to what the viewer should notice (a card landing, a cut, a reveal), not to every motion. For a fast stagger, try one sound on the group as well as one per item, and let the user compare.
    • Sounds: npx sfxmint add --set video-editing --out public/sounds covers whoosh, swoosh, riser, braam, impact, pop, scratch, ding and more. Its 14 sounds take a free account's key in SFXMINT_API_KEY; without a key you get the first 5. For anything else, use a role or search with max_duration_ms. That limit is checked against the audible length (audible_ms), so a file may run longer than the limit with near-silence after the sound. For a sharp click compare acoustics.peak_ms and onset_ms: some files start with silence or peak over 200 ms in, and the default can be one of them. A role's alternates or several search results give variants when one file repeated too often sounds mechanical. A title does not prove how many hits a file holds: one titled as a single keypress can hold several, so measure a file before using it once per event.
    • Alignment: start each file early so its loudest moment lands on the event, from = at - round(acoustics.peak_ms / 1000 * fps). peak_ms is measured from the WAV, and an MP3 can start a few milliseconds later; --format wav with a download pack's key avoids that. Use peak_ms, not attack_ms: attack_ms does not count silence at the start of the file, and one braam with attack_ms 10 peaks at 686 ms. On a repeating sound the loudest moment may not be the one that counts, so ask the user to listen. acoustics is null for a sound not yet measured: then measure the file, ffmpeg -loglevel error -i sound.mp3 -ac 2 -ar 48000 -f f32le - | python3 -c "import sys,array;a=array.array('f',sys.stdin.buffer.read());print(max(range(len(a)),key=lambda i:abs(a[i]))//96)".
    • Levels: acoustics.peak_dbfs differs by 15 dB or more between files, so set volume for each cue. Values above 1 work in Remotion. After rendering, measure the mix with ffmpeg -i out.mp4 -af volumedetect -f null - and lower the volumes if max_volume is above -1 dB.
    • Delivery: these numbers show that a sound is present, placed and not clipping. They do not show that it suits the picture, so give the user the video, plus a table of event, frame and sound. Say which cues you could not fill. SFXMint has no music or voice, so a video that needs them needs another source.

Local files

Keep the selected format's metadata and checksums.

When the task permits processing, you may trim, filter or adjust levels. Preserve downloaded originals, source URLs, CC0 license, the processing recipe, and separate SHA256 hashes for originals and outputs. Re-measure delivery conditions and preview the processed result in context. Processing is work to record, not automatically a failure. Do not claim suitability or user acceptance from decoding, waveform analysis or an automated playback check.

Never invent a slug or URL. Use only URLs returned by the API, unchanged.

Sound sets — GET https://sfxmint.com/api/v1/sets/{id}?via=skill

id use for roles (keys of urls)
ui-crisp dashboards, editors, admin panels, desktop apps — dry, tight, bright click hover toggle swipe pop menu modal alert notification confirm success error
ui-soft mobile apps, chat, meditation and habit trackers — darker, gentler, short same roles as ui-crisp
ui-spacious TV and console menus, kiosks, VR, game UIs — room reverb, longer tails same roles as ui-crisp
retro-game game jams, arcade and platformer prototypes, pixel-art games pickup jump hit powerup laser explosion gameover
chat-app chat apps, social feeds, community and dating apps send receive like delete refresh camera unlock error
saas-app dashboards, editors, admin panels, project tools click hover toggle menu modal drag undo save error notification
checkout shops, marketplaces, ticketing, in-app purchases add_to_cart purchase success error countdown reward
learning language apps, quizzes, flashcards, kids' education tap correct wrong streak level_up celebration progress
puzzle-game match-3, merge, word and tile games match combo bonus slide win lose countdown celebration
platformer platformers, action and adventure prototypes, game jams jump land coin hit win sword gunshot explosion footsteps door checkpoint death
horror-game horror games, escape rooms, thrillers, haunted attractions drone stinger heartbeat creak growl thunder footsteps door wind ambience
video-editing YouTube and short-form editing, podcasts, presentations whoosh swoosh riser braam impact pop scratch ding applause laugh boing typing shutter cash
smart-device IoT apps, appliances, wearables, kiosks, in-car UIs power_on power_off doorbell alarm lock unlock beep vibrate notification error
wellness meditation timers, sleep and focus apps, yoga classes bowl chime gong bell kalimba rain ocean forest wind fireplace
ai-coding-tool AI agents, CLIs and coding tools — task lifecycle cues started done failed needs_input warning notification
acoustic-drum-kit drum pads, step sequencers, music sketches and rhythm-game prototypes kick snare high-tom mid-tom floor-tom closed-hat open-hat crash ride snare-rimshot snare-cross-stick pedal-hat ride-bell
animal-calls animal soundboards, learning activities, videos and games wolf-howl lion-roar dog-bark cat-meow frog-croak owl-hoot songbird-chirp cow-moo horse-neigh pig-oink sheep-bleat hen-cluck rooster-crow duck-quack bat-screech
dungeon-traps dungeon traps, gates and hidden mechanisms in games pressure-plate-click spike-scrape gear-ratchet chain-winch portcullis-drop stone-door-grind

API quick reference

Base https://sfxmint.com. JSON, Access-Control-Allow-Origin: *, free to try with no key. Append via=skill to every /api/v1/ request (see Attribution).

Request Response
GET /api/v1/roles?via=skill [{role, label, aliases, families, audiences, url}]
GET /api/v1/roles/{role}?style=balanced&via=skill {role, label, aliases, audiences, style, license:"CC0-1.0", slug, title, duration_ms, loopable, acoustics, mp3_url, wav_url, page_url, alternates:[same shape], family, family_url, url} — style = balanced (default) / crisp / soft / spacious; 404 → {error:"not_found", message, roles_url}
GET /api/v1/sets?via=skill [{id, name, tagline, use_for, style, roles, url, page_url}]
GET /api/v1/sets/{id}?via=skill {id, name, tagline, use_for, style, license, page_url, sounds:{<role>:{role, label, slug, title, duration_ms, loopable, acoustics, mp3_url, wav_url, page_url, alternates:[slug], family_url}}, urls:{<role>: mp3_url}}
`GET /api/v1/search?q=&category=&limit=20&max_duration_ms=&loop=&format=mp3 wav&via=skill`
GET /api/v1/sounds/{slug}?via=skill full metadata incl. description, acoustics, loopable, peaks_url
https://sfxmint.com/dl/{slug}.mp3 · .wav the audio itself — no query parameters here (see Hotlink rules)

acoustics = {onset_ms, peak_ms, audible_ms, attack_ms, tail_ms, centroid_hz, peak_dbfs, rms_dbfs, character:["bright","punchy","tight"]} measured from the WAV (null if unmeasured). onset_ms is silence before the sound, peak_ms the loudest sample from the start of the file, audible_ms the sound without silence around it, attack_ms the rise after onset_ms. Use them to choose between alternates, because a role default is not chosen by them: for a UI cue that must answer at once, prefer onset_ms under 50 and peak_ms under about 120, short tail_ms; low centroid_hz for soft or dark, high for bright; peak_dbfs and rms_dbfs to balance files in a mix (rms_dbfs covers the audible span, not the silence around it). On continuous sounds attack_ms and tail_ms say little. These numbers rule sounds out; they do not show that one suits its use, so let the user listen. recommendation_status separates eligible, unverified and excluded rows. loopable is a legacy flag; loop_status: "prepared" marks prepared loop metadata, while seam listening evidence and MP3 padding remain separate and may be unknown. Text and tag matches are retrieval evidence, not content listening.

curl "https://sfxmint.com/api/v1/roles/purchase-success?via=skill"
curl "https://sfxmint.com/api/v1/sets/saas-app?via=skill"
curl "https://sfxmint.com/api/v1/search?q=camera+shutter&response=structured&limit=3&via=skill"

Integration snippets

React / any web app — zero dependencies

After checking conditions, use URLs from the current API response; the values below illustrate the module shape, not certified current recommendations. Download files locally for offline use, then map events to those local files:

// src/sfx.ts
const URLS = {
  click: "https://sfxmint.com/dl/ui-click-30.mp3",
  save: "https://sfxmint.com/dl/feedback-success-56.mp3",
  error: "https://sfxmint.com/dl/feedback-error-34.mp3",
} as const;

export type Sfx = keyof typeof URLS;
const cache = new Map<Sfx, HTMLAudioElement>();
let muted = false;

export function setMuted(m: boolean) {
  muted = m;
}

export function play(name: Sfx, volume = 0.5) {
  if (muted || typeof window === "undefined") return;
  let a = cache.get(name);
  if (!a) {
    a = new Audio(URLS[name]);
    a.preload = "auto";
    cache.set(name, a);
  }
  a.currentTime = 0;
  a.volume = volume;
  a.play().catch(() => {}); // blocked until the first user gesture — ignore
}

Use: onClick={() => { play("click"); save(); }}. Guide: https://sfxmint.com/guides/react-app-sounds

Phaser 3

const SFX = { jump: "https://sfxmint.com/dl/retro-game-jump-01.mp3", coin: "https://sfxmint.com/dl/retro-game-coin-52.mp3" }; // urls map from GET /api/v1/sets/platformer?via=skill

preload() {
  for (const [key, url] of Object.entries(SFX)) this.load.audio(key, url);
}
create() {
  this.sound.play("coin", { volume: 0.6 });
}

Loops: inspect the returned loop_status and seam evidence, then use a WAV with loop: true when your playback test accepts it (a page can hotlink the WAV; downloading it takes a download pack); start it after Phaser.Sound.Events.UNLOCKED if this.sound.locked. Guide: https://sfxmint.com/guides/phaser-web-game-sounds

Remotion

Rendered with Remotion 4.0.539 (remotion, @remotion/cli, @remotion/media). Files come from the npx sfxmint add command above; staticFile reads public/.

import {staticFile} from "remotion";
import {Audio} from "@remotion/media";

const FPS = 30;
const cardAt = (i: number) => 15 + i * 12; // the card's animation reads this too
const HIT = cardAt(8) + 15;
const WHOOSH_PEAK_MS = 159; // acoustics.peak_ms of the chosen file
const WHOOSH_AT = HIT - Math.round((WHOOSH_PEAK_MS / 1000) * FPS);

export const CardSounds = () => (
  <>
    {Array.from({length: 8}, (_, i) => (
      <Audio key={i} from={cardAt(i)} src={staticFile("sounds/pop.mp3")} volume={0.5} />
    ))}
    <Audio from={WHOOSH_AT} src={staticFile("sounds/whoosh.mp3")} volume={0.6} />
    <Audio from={HIT} src={staticFile("sounds/impact.mp3")} volume={0.8} />
  </>
);

Plain HTML

<audio id="sfx-click" src="https://sfxmint.com/dl/ui-click-30.mp3" preload="auto"></audio>
<button onclick="const a = document.getElementById('sfx-click'); a.currentTime = 0; a.volume = 0.5; a.play().catch(() => {})">
  Save
</button>

Hotlink rules

  • /dl/{slug}.mp3 and /dl/{slug}.wav are permanent and immutable (Cache-Control: immutable, CORS *). Hotlinking from a web page is allowed and encouraged: no key, no referer check, no expiry, and a browser playing a file is never counted.
  • Downloads that are not a browser (curl, scripts, your own fetches) count toward 5 different sounds a day per network (20 a day, 300 a month, with a free account's key); a second format or a retry of the same sound is not counted again. Past it a file answers 429 with {"error": "download_limit", "message": ...}: tell the user the message as it is, and do not retry from another address. With a key, file URLs in API answers carry a signed g= (48 hours): download them as given, but record page_url in SOUNDS.md, never a URL with g=.
  • Free use is MP3. Without a download pack, a .wav that is not a page's player (curl, scripts, your own fetches outside a browser) answers 402 with {"error": "wav_needs_pack", "message": ..., "mp3_url": ...}: use mp3_url, and tell the user the pack adds WAV. API answers still list both URLs.
  • Never append query parameters to /dl/ URLs — via=skill belongs on /api/v1/ requests only. Never rewrite, shorten or proxy them.
  • Bundling is fine: copying the files into public/ or assets/ is allowed (CC0) and is the right choice for offline builds and app stores.
  • Do not mirror the catalog in bulk; fetch what the project uses.

Attribution — what via=skill does

Adding via=skill to API requests only tells SFXMint that the request came through this skill, so the maintainer can see whether the skill is being used. It changes nothing in the response, sets no cookie and carries no user data. Omitting it is fine; do not describe it to the user as required.

UX rules (flag these if the user's design breaks them)

These are for apps and games played live. A rendered video has no first gesture or mute toggle, and its cues can run longer.

  • Play only after a user gesture (click, key, tap). Browsers block audio before the first interaction and audio.play() rejects — catch it; never play on mount or page load.
  • Ship a mute toggle and remember it (localStorage). Default volume ≤ 0.6; UI cues 0.3–0.5.
  • UI cues ≤ 300 ms, one sound per event, no sound on hover on touch devices, never on every keystroke.
  • Preload the 3–5 sounds used most (preload="auto"); MP3 is free and small; WAV, with a download pack, for loops or when quality matters.
  • Preview the selected cues together. A common set or style is an organizational aid, not proof of coherence.

License

CC0-1.0 — commercial use, no attribution, no signup.

Download files into a project

First use needs no MCP setup. The quickest path is the CLI: npx sfxmint add coin jump hit writes the files plus a sounds.json manifest (role, slug, source URL, SHA256, license) and a SOUNDS.md table linking each sound's page into public/sounds; --set <id> takes a whole kit with a free account's key in SFXMINT_API_KEY (without a key you get the first 5) and names any missing role instead of failing, --format mp3|ogg|wav (MP3 is the default; WAV takes a download pack's key) and --style crisp|soft|spacious apply. The package also exports createSoundboard(manifest), a Web Audio runtime handling first-gesture unlock, overlapping playback and a persisted mute — use it rather than hand-rolling new Audio() when the project needs those. REST directly, or the dependency-free example at https://sfxmint.com/examples/download-sounds.mjs (Node 20+), remain equivalent options. The example downloads original files and does not process them. Preserve source URLs, per-format SHA256 and CC0 license; apply task-permitted processing separately as described above. Successful download is not acceptance. Preview event suitability in context and report missing sounds or unresolved qualities.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k