sound skill
The sound skill searches and downloads Freesound effects for video, weighing downloads, ratings, uploader description and license.
- 587 ★ on the repository
- Last commit
Extended access
Why this level
- A helper script can change local Clash configuration and switch a node.
- Scripts reach the network and download files to disk.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/soundDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A helper script can change local Clash configuration and switch a node.
- Scripts reach the network and download files to disk.
This is third-party code. Review the repository files before installing.
What it does
The skill turns a scene description into an English query, searches Freesound and ranks candidates by download count, rating count, uploader text, duration and license. The agent cannot hear clips, so it relies on what people who did hear them left behind, and provides preview links. The `sfx.py` script searches and downloads in parallel. It fetches MP3 previews, not the author's originals. Duration and energy can be checked with FFmpeg.
Who it is for. Video editors and developers who pick sounds for transitions, clicks and card entrances.
Good fit when
- A short whoosh of about 0.3 seconds is needed for a card flying in.
- A soft, non-harsh click is wanted for a toggle.
- Only CC0 sound is acceptable.
- A candidate list with preview links is required before choosing.
Not a fit when
- Ready-made music or voice-over is needed.
- A sound must be created, not found.
- Freesound is unreachable from the environment.
Example request
Find a short card fly-in sound on Freesound, CC0 only, and show candidates with preview links.Limitations
Downloads are MP3 previews, not originals. Each sound has its own license; no filter is set by default and BY-NC clips can appear, so restrict commercial work with `--license cc0`. The helper `clash_freesound.py --fix` changes the local Clash configuration and switches a node, so run it only in a matching environment. The skill text offers a paid full version, with payment handled outside the repository.
How to disable. Delete the `.claude/skills/sound` directory and the `~/.cache/sfx-sources/` cache.
FAQ
How are only free sounds selected?
Add `--license cc0` to the search. `by` keeps CC0 and Attribution, and `any` applies no filter.
Where do sounds come from?
From Freesound. The README names it as the only source, and search runs against its database.
What if Freesound times out?
Check Freesound access and the terminal proxy. A script exists for the author's setup, but it edits the local Clash configuration.
What lands on disk?
MP3 previews from Freesound. Search results are cached in `~/.cache/sfx-sources/index.json`, and downloads rely on that cache.
Is a key or extra package needed?
No, the scripts use only the Python 3 standard library. Claude Code and Freesound access are required.
Discussion
No questions or reviews yet.
Related
SkillsSkill that turns a video into tall subtitle collages: crops burned-in subtitles or draws reviewed lines onto real frames
Thirteen skills for the Sonilo API: video-matched music, sound effects, dubbing and ducking of music under a voice.
The Video by Reference skill learns style from a sample clip and builds an animated short from code with an original soundtrack
Clipwing skills for video: HyperFrames to After Effects conversion and sound design with real recorded effects.
A skill that turns your narration and real assets into a 20–60 second video in the style you pick, rendered locally as MP4.
A skill that turns a topic into a narrated 4K video: research, script, local TTS, Remotion composition and an FFmpeg mix
README in short
The README is in Chinese: installation by cloning into `.claude/skills/sound`, sample requests and a table of search options.