Index of every page on this site: llms.txt
All skills
hktitan avatar

/khe-sound

@945e23c
by Harshit Khemanihktitan/skills47 stars
2
Run it yourself

Decides which moments in a product UI or a launch video earn a sound or a haptic, designs one material family, generates the files with ElevenLabs or an offline synth, and places each transient on the frame where the motion lands. Use when someone says "add a sound", "it needs a satisfying click", "should this make a sound?", "the click feels late", "the sounds feel stock", or wants UI sound effects, a mute toggle, vibration on the mobile web, or a soundtrack placed on a locked film. For the motion a sound lands on use `khe-ui`; for a film's register, beats and cuts use `khe-launch-film`.

Use this Skill: https://skilld.dev/gh/hktitan/skills/khe-sound

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

README.md

≈1.4k tokens on demand. Your agent reads this file only when SKILL.md points to it.

khe-sound

Which moments earn a sound or a haptic, one material family, generated and synced to motion.

npx skills add HKTITAN/skills --skill khe-sound

What it does

  • Decides, moment by moment, whether a sound or a haptic is earned, and rejects most of them.
  • Designs one material family of four to six sounds and generates it with ElevenLabs or an offline synth.
  • Wires playback for the web: off by default, unlocked on the first gesture, each transient on its contact frame.
  • Places a film's sound on locked picture: the register, the cue sheet, the track's drop and the loudness.

How it runs

khe-sound's flow: a settled move from khe-ui, locked picture from khe-launch-film or a locked take from khe-demo comes in; each moment is judged earned or not and most stay silent in the ledger; the rest become one material family of four to six sounds, generated with ElevenLabs or a synth, and placed 0 to 30 ms after the contact frame

Used

/khe-sound Our to-do app feels flat. Should checking off a task make a sound?

No. Seven moments were proposed and four stay silent, each with its reason. From examples/product-cues.json:

"defaultOn": false,
"silent": [
  { "moment": "typing a task", "why": "heard on every keystroke: never" },
  { "moment": "checking a task off", "perDay": 40, "why": "nothing the eye misses, and the 100th use reaches for mute" },
  { "moment": "hovering a row", "why": "hover is 0 ms" },
  { "moment": "opening the settings sheet", "why": "decoration: the sheet arriving is already the signal" }
],

The three that earned a sound (a sync that finishes while you are elsewhere, a rejected task, the 30-day streak) come from one material, "felt mallet on a small wooden block", in examples/family.json. Two of the rendered files: tick.wav and send.wav. The gate on the map, the family, the files and examples/wiring.js ends sound check passed.

When to use it

Reach for it when a product or a launch video needs sound and you want fewer, better ones. It answers "should this make a sound?" in one line, builds a family that belongs to one object, and fixes sounds that feel stock, late or annoying. It also covers vibration on the mobile web and the licence check for any recording that goes into a film.

Invoke with

/khe-sound [target]

Or describe the problem in your own words. The skill's description carries the triggers, so no special wording is needed.

Before and after

Before: a click on every button and a whoosh on page changes; tick.wav is stereo, 640 ms, with 12 ms of silence before the hit; sound is on by default.

After: silent by default; one opt-in 180 ms two-note sync tone; tick is mono, 70 ms, peaked at -3 dBFS, and lands 0 to 30 ms after its contact frame.

Example prompts

  • Our to-do app feels flat. Should checking off a task make a sound?
  • The click in my launch video lands a few frames after the cursor presses. Why does it feel late?
  • I need a tick, a send and an error sound that belong together, and I don't have an ElevenLabs key.

Pairs with

  • khe-ui: a transient needs a contact frame, so the move has to be settled before a sound can be placed on it.
  • khe-launch-film: the film's register, reveal and cuts decide where the drop, the gaps and the breakdowns go, and picture must be locked there first.

Verify

node scripts/sound-check.mjs <sound-map.json> <family.json> <sfx folder> <playback file> --gate
node scripts/sound-check.mjs --self-test

The gate reads sound manifests, cue sheets, .wav files (from the RIFF header and the PCM samples) and web playback code, with no dependencies, and prints one named line per fault. --gate ends sound check passed only when every never-intentional line is at 0: no sound on typing, scroll, hover or focus, a declared mute that starts off, a visual twin per cue, one material, every cue on a time or a frame, no negative lag, lengths and peaks inside the spec, no lead-in of 5 ms or more, a licence per file, and for a film a locked picture, a register, a loudness and a -1 dBTP ceiling. With nothing to read it says inconclusive and exits 2.

What it proves: the numbers and the declarations. What it does not: feel, timbre, whether the sound suits the product, the 100th-use test, sync on the rendered picture, LUFS and true peak, and haptics on a real phone. Those are in references/verify.md under "Not checked by the gate". Passing is necessary, not sufficient.

What is inside

  • SKILL.md: the one idea, the workflow with an exit per step, the rules.
  • references/: 18 references the agent opens one at a time, including verify.md (the last pass and the CUES.md handover), review.md (the fresh-eye brief) and teaching.md, plus gotchas.md and pov.md, which are yours to edit.
  • examples/: the gold. A family manifest, a product sound map, a film cue sheet, web playback wiring and two finished .wav one-shots.
  • teaching/: 14 bad/good pairs, one folder per gate line, each the same artifact with one thing wrong. They are also the gate's tests.
  • scripts/: sound-family.mjs (a manifest to files), sound-sheet.mjs (a cue sheet to a stem), sound-check.mjs (the gate).
  • LICENSE: MIT.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning4d3 checks · Risk SAFE
  • Gen Agent Trust Hub4d

    The khe-sound skill is a sound engineering extension for designing and generating audio assets for UI and film. It utilizes local synthesis and the ElevenLabs API for audio generation. The skill follows secure development practices, including environment-variable-based secret management and rigorous input validation in its automation scripts to prevent command injection and path traversal. No security issues were detected.

  • Socket4d

    No alerts

  • Snyk4d

    Risk: MEDIUM · 1 issue

Signed by skilld at 945e23c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
metadata
{
  "author": "Harshit Khemani",
  "version": "1.0.0"
}

README badge

README badge for hktitan/skills/khe-sound