paper-cranes: Skill for Claude Code

Solo — Shader Knob/Audio Mode Toggle

Toggle a shader between knob mode (manual knob_* uniforms for live tuning) and audio mode (audio-reactive features driving the visuals).

Context

Arguments: !echo "$ARGUMENTS"

Target shader (from arguments or git diff): !args="$ARGUMENTS"; shader=$(echo "$args" | grep -oE '[^ ]+\.frag'); if [ -n "$shader" ]; then echo "$shader"; else git diff --name-only HEAD | grep '\.frag$' | head -1 || git diff --cached --name-only | grep '\.frag$' | head -1 || echo "(no .frag files modified in worktree)"; fi

Current mode of target shader (knobs active = "knob_mode", audio active = "audio_mode", not yet knobified = "raw"): !args="$ARGUMENTS"; shader=$(echo "$args" | grep -oE '[^ ]+\.frag'); if [ -z "$shader" ]; then shader=$(git diff --name-only HEAD | grep '\.frag$' | head -1); fi; if [ -n "$shader" ] && [ -f "$shader" ]; then if grep -qP '^#define \S+ .*knob_' "$shader" && grep -qP '^// #define \S+ .*(?:bass|treble|energy|mids|spectral|pitchClass)' "$shader"; then echo "knob_mode"; elif grep -qP '^// #define \S+ .*knob_' "$shader" && grep -qP '^#define \S+ .*(?:bass|treble|energy|mids|spectral|pitchClass)' "$shader"; then echo "audio_mode"; else echo "raw"; fi; else echo "no_shader_found"; fi

Highest knob number already used across all shaders (to avoid collisions): !grep -roh 'knob_[0-9]\+' shaders/ 2>/dev/null | sed 's/knob_//' | sort -n | tail -1 || echo "0"

Determine mode and target

Parse $ARGUMENTS:

• First word may be knobs or audio (the mode). If omitted, auto-toggle based on the shader's current state:
  • If currently in knob_mode → switch to audio
  • If currently in audio_mode → switch to knobs
  • If raw (not yet knobified) → use knobs
• Remaining argument is the path to a .frag file. If omitted, find the first .frag modified in the git worktree.
• If no shader can be found, ask the user.

---

Mode: knobs

Transform the shader so its tunable parameters use knob_* uniforms, with commented-out audio-reactive #define alternatives.