agentleFS
renatoworksrenatoworks/strudel-claude/.claude/skills/visuals/SKILL.md

visuals

Skill61 starsChanged 10 months agoMITView on GitHub

Add psychedelic visual feedback to Strudel patterns. Use when you want trippy, colorful, or informative visualizations.

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use rayfin-functions.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • MicrosoftSkill

    rayfin-functions

    Use when writing Rayfin user-defined functions (UDFs), invoking functions from frontend code, or using functions CLI commands. Triggers: rayfin functions, udf.func, UserDataFunctions, RayfinContext, FabricContext, AppFunctionsSchema, functions init, dev functions apply, client.functions, invoke, func start, function_app.ts, types.ts, rayfin/functions/, FunctionClient, FunctionsSchema, fabric-user-data-functions, functionsBaseUrl, VITE_RAYFIN_FUNCTIONS_URL, bootstrap.ts, rayfinClient.ts

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Rule: Use _ prefix for inline visuals (can stack multiple), no prefix for background.

    line 25

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Strudel Visuals

Make your patterns come alive with visual feedback. Always add visuals - music should be seen, not just heard.


Quick Start

// Inline visuals (multiple allowed, rendered in code)
note("c a f e")._pianoroll()
note("c a f e")._spiral()
s("bd sd")._scope()

// Background visuals (one at a time, full page)
note("c a f e").pianoroll()

Rule: Use _ prefix for inline visuals (can stack multiple), no prefix for background.


Color Your Patterns

Everything starts with .color() - it affects highlighting AND visuals.

// Single color
note("c a f e").color("cyan")

// Pattern colors (cycles through)
note("c a f e").color("cyan magenta yellow")

// Hex colors
note("c a f e").color("#ff00ff #00ffff #ffff00")

// Neon acid palette
.color("cyan magenta yellow #ff6600")

// Vaporwave
.color("#ff71ce #01cdfe #05ffa1 #b967ff")

// Fire
.color("#ff0000 #ff6600 #ffff00")

Pianoroll / Punchcard

Scrolling note visualization. The bread and butter of live coding visuals.

// Basic
note("c a f e")._pianoroll()

// Full acid mode
note("c2 eb2 f2 g2")
  .color("cyan magenta")
  ._pianoroll({
    smear: 1,           // Notes leave trails (TRIPPY!)
    cycles: 8,          // Show more cycles
    labels: 1,          // Show note names
    active: "#ff00ff",  // Active note color
    inactive: "#00ffff", // Inactive note color
    vertical: 1,        // Vertical mode
    fold: 1,            // Notes fill full width
  })

All Pianoroll Options

OptionTypeDefaultEffect
smearbool0Notes leave solid trails
foldbool0Notes take full width
cyclesint4Cycles visible at once
verticalbool0Vertical orientation
labelsbool0Show note labels
playhead0-10.5Playhead position
flipTimebool0Reverse scroll direction
flipValuesbool0Flip note positions
activecolor#FFCA28Active note color
inactivecolor#7491D2Inactive note color
backgroundcolortransparentBackground color
playheadColorcolorwhitePlayhead line color
fillbool0Fill all notes
fillActivebool0Fill active notes only
strokebool0Show note borders
hideInactivebool0Only show active notes
colorizeInactivebool1Use pattern color for inactive
autorangebool0Auto-fit note range
minMidiint10Min note displayed
maxMidiint90Max note displayed

Trippy Pianoroll Recipes

// Smeared neon trails
._pianoroll({ smear: 1, active: "#ff00ff", inactive: "#00ffff" })

// Vertical waterfall
._pianoroll({ vertical: 1, smear: 1, cycles: 16 })

// Minimal active-only
._pianoroll({ hideInactive: 1, fillActive: 1, cycles: 2 })

// Full labels
._pianoroll({ labels: 1, fill: 1, autorange: 1 })

Spiral

Circular visualization - hypnotic and mesmerizing.

// Basic
note("c a f e")._spiral()

// Trippy spiral
note("c a f e")
  .color("#ff6600 #ff00ff #00ffff")
  ._spiral({
    steady: 0.96,       // Less jumpy (0-1)
    logSpiral: 1,       // Logarithmic spiral (COOL!)
    thickness: 4,       // Line thickness
    fade: 1,            // Fade past/future
    stretch: 2,         // Rotations per cycle
  })

All Spiral Options

OptionTypeDefaultEffect
steady0-10Smoothness (0.96 = smooth)
logSpiralbool0Logarithmic spiral
fadebool1Fade past/future
stretchnum1Rotations per cycle
sizenum-Spiral diameter
thicknessnum-Line thickness
insetnum3Rotations before start
paddingnum-Space around spiral
capstringbuttLine ends: butt/round/square
playheadColorcolorwhitePlayhead color
playheadLengthnum0.02Playhead size
activeColorcolor-Active segment color
inactiveColorcolor-Inactive segment color
colorizeInactivebool0Use pattern colors

Trippy Spiral Recipes

// Logarithmic hypnosis
._spiral({ logSpiral: 1, steady: 0.96, thickness: 6 })

// Tight fast spiral
._spiral({ stretch: 4, steady: 0.9, fade: 0 })

// Thick colorful
._spiral({ thickness: 8, colorizeInactive: 1, steady: 0.96 })

Scope (Oscilloscope)

Real-time waveform visualization - see your sound.

// Basic
s("sawtooth")._scope()

// Styled scope
s("sawtooth")._scope({
  color: "#00ff00",    // Matrix green
  thickness: 4,        // Thicc lines
  scale: 0.5,          // Zoom in on waveform
})

All Scope Options

OptionTypeDefaultEffect
colorcolorwhiteLine color
thicknessnum3Line thickness
scalenum0.25Y-axis zoom
alignbool1Align to zero crossing
pos0-1-Y position on screen
triggernum0Alignment amplitude

Scope Recipes

// Neon green matrix
._scope({ color: "#00ff00", thickness: 4 })

// Hot pink
._scope({ color: "#ff00ff", thickness: 5, scale: 0.6 })

// Subtle background
._scope({ color: "#ffffff33", thickness: 2 })

Spectrum (Frequency Analyzer)

See the frequencies - bass on the left, treble on the right.

// Basic
s("supersaw")._spectrum()

// Styled
s("supersaw")._spectrum({
  thickness: 3,
  speed: 2,           // Scroll speed
  min: -60,           // Min dB
  max: 0,             // Max dB
})

Pitchwheel

Pitch circle for visualizing notes within an octave.

n("0 .. 12").scale("C:chromatic")._pitchwheel()

Combining Visuals

Stack multiple inline visuals for maximum impact.

setcpm(130/4)

// Bass with smeared pianoroll
$: note("c2 eb2 f2 g2".fast(2))
  .s("sawtooth").lpf(800)
  .color("cyan magenta")
  ._pianoroll({ smear: 1, cycles: 8 })

// Drums with scope
$: s("bd sd hh hh").bank("RolandTR909")
  ._scope({ color: "#00ff00", thickness: 4 })

// Lead with spiral
$: n("0 3 7 10".fast(2)).scale("C:minor").s("square")
  .color("#ff6600 #ff00ff")
  ._spiral({ logSpiral: 1, steady: 0.96 })

// Pad with spectrum
$: chord("<Cm7 Fm7>").voicing().s("supersaw")
  ._spectrum({ thickness: 2 })

Acid Visual Presets

Neon Rave

.color("cyan magenta yellow")
._pianoroll({ smear: 1, active: "#ff00ff", inactive: "#00ffff" })

Matrix

.color("#00ff00")
._pianoroll({ smear: 1, active: "#00ff00", inactive: "#003300", vertical: 1 })

Vaporwave

.color("#ff71ce #01cdfe #05ffa1 #b967ff")
._spiral({ logSpiral: 1, steady: 0.96, thickness: 5 })

Fire

.color("#ff0000 #ff6600 #ffff00")
._pianoroll({ smear: 1, active: "#ffff00", inactive: "#ff3300" })

Minimal Techno

.color("white")
._pianoroll({ hideInactive: 1, fillActive: 1, cycles: 2 })

Pro Tips

  1. Always use steady: 0.96 on spirals - makes them smooth
  2. smear: 1 is the secret sauce for trippy pianorolls
  3. Match colors to your vibe - neon for acid, muted for ambient
  4. logSpiral: 1 makes spirals way cooler
  5. Combine visuals - pianoroll + scope + spiral = full experience
  6. Use .color() patterns - colors that change with notes

Philosophy

If it sounds good, it should look good.

Visuals aren't decoration - they're part of the performance. Let people see the music breathe.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.