Agent skill

Flutter Soloud Volume Pan

by alnitak in alnitak/flutter_soloud

Teaches volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter…

MITAuto-check passedMobile

Install Flutter Soloud Volume Pan

skills CLI
$ npx skills add alnitak/flutter_soloud --skill flutter-soloud-volume-pan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alnitak/flutter_soloud flutter-soloud-volume-pan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alnitak/flutter_soloud.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flutter-soloud-volume-pan .claude/skills/flutter-soloud-volume-pan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-soloud-volume-pan
GitHub stars
425
Token cost
~1.7k tokens
SKILL.md length
672 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Teaches volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter…

  • The user asks to change a sounds volume
  • SKILL.md covers Minimal example, The API shape, Traps and More depth, plus 1 more section
  • Calls dart
  • Pan a sound left/right

What it does

Flutter Soloud Volume Pan is an agent skill from alnitak/flutter_soloud. Teaches volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter filter as the anti-clipping tool. Use when the user asks to change a sound's volume, pan a sound left/right, fade or oscillate audio parameters, build a VU meter, or stop clipping when many sounds play at once.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps. It works with Flutter and Dart. The repository describes itself as: Flutter low-level audio plugin using SoLoud C++ library and FFI. The licence is MIT.

When your agent uses it

  • The user asks to change a sounds volume
  • Pan a sound left/right
  • Oscillate audio parameters
  • Build a VU meter

Example prompts

  • “Use the flutter-soloud-volume-pan skill to teach volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including…”
  • “/flutter-soloud-volume-pan”

What it can do on your machine

Read from SKILL.md and the folder at commit 289697e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • dart

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter Soloud Volume Pan loads about 1.7k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 672 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~109
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alnitak/flutter_soloud at commit 289697e, republished under its MIT licence (© alnitak). 672 words, ~1,738 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-soloud-volume-pan/SKILL.md (or your agent's skills folder).
name
flutter-soloud-volume-pan
description
Teaches volume, pan, fade, oscillator, and scheduled-stop control in the flutter_soloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter filter as the anti-clipping tool. Use when the user asks to change a sound's volume, pan a sound left/right, fade or oscillate audio parameters, build a VU meter, or stop clipping when many sounds play at once.
version
1

Volume and pan in flutter_soloud are applied to handles (one per playing voice), not to the loaded AudioSource. Loading a sound gives an AudioSource; each play() returns a SoundHandle you control afterwards. Global volume is engine-wide and multiplies with per-handle volume. Fades, oscillations, and scheduled pause/stop run on the engine's internal fader clock, not on Dart timers.

Minimal example

dart
import 'package:flutter_soloud/flutter_soloud.dart';

Future<void> main() async {
  await SoLoud.instance.init();

  final source = await SoLoud.instance.loadAsset('assets/sfx.ogg');

  // volume and pan can be set at play time...
  final handle = SoLoud.instance.play(source, volume: 0.8, pan: -0.5);

  // ...or changed afterwards on the handle.
  SoLoud.instance.setVolume(handle, 0.6);
  SoLoud.instance.setPan(handle, 0); // 0 = centered

  // Fade out over 2 s, then stop 2 s from now.
  SoLoud.instance.fadeVolume(handle, 0, const Duration(seconds: 2));
  SoLoud.instance.scheduleStop(handle, const Duration(seconds: 2));

  SoLoud.instance.setGlobalVolume(0.9); // master volume, all sounds
}

The API shape

All members of SoLoud.instance. Everything throws SoLoudNotInitializedException if init() has not completed.

Per-handle volume / pan:

  • void setVolume(SoundHandle handle, double volume) / double getVolume(handle) — 0.0 muted, 1.0 full. Per-voice gain; multiplies with global volume.
  • void setPan(SoundHandle handle, double pan) / double getPan(handle) — -1.0 = full left, 0.0 = CENTER, 1.0 = full right. Diverges from audioplayers (whose setBalance uses the same range) and from just_audio (no pan at all), but trips up models assuming 0..1: setPan(handle, 0.5) is half-right, not "half volume". Debug builds assert the range; release builds clamp to -1..1.
  • void setPanAbsolute(SoundHandle handle, double panLeft, double panRight) — sets the L/R channel volumes directly (each -1..1). Bypasses the pan law. Does not affect what getPan returns.

Global:

  • void setGlobalVolume(double volume) / double getGlobalVolume() — 0.0..1.0, affects every voice.

Fades (signature: (handle, to, Duration time), global variant omits the handle):

  • void fadeVolume(SoundHandle handle, double to, Duration time)
  • void fadePan(SoundHandle handle, double to, Duration time)
  • void fadeRelativePlaySpeed(SoundHandle handle, double to, Duration time) — ramps playback speed (and pitch, since SoLoud resamples).
  • void fadeGlobalVolume(double to, Duration time)

Oscillators (signature: (handle, from, to, Duration time) — time is the full period of one from→to→from cycle):

  • void oscillateVolume(SoundHandle handle, double from, double to, Duration time)
  • void oscillatePan(SoundHandle handle, double from, double to, Duration time)
  • void oscillateRelativePlaySpeed(SoundHandle handle, double from, double to, Duration time)
  • void oscillateGlobalVolume(double from, double to, Duration time)

Scheduled actions (engine-clock, no Dart Future.delayed needed):

  • void schedulePause(SoundHandle handle, Duration time)
  • void scheduleStop(SoundHandle handle, Duration time)

Metering:

  • double getApproximateVolume(int channel) — per-output-channel post-mix level for VU meters (channel 0 = left, 1 = right in stereo). Only returns non-zero when visualization is enabled: SoLoud.instance.setVisualizationEnabled(true) first. Returns 0 for an invalid channel index.
Show full SKILL.md (358 more words)Show less

Traps

  • Simultaneous sounds sum and clip. Two voices at volume 1.0 can exceed full scale and distort; lowering volumes per-sound is a losing battle. The intended fix is the global limiter filter, which caps the mixed output:

    dart
    await SoLoud.instance.init();
    SoLoud.instance.filters.limiterFilter.activate();
    // Optionally lower the ceiling (dB, should stay < 0):
    SoLoud.instance.filters.limiterFilter.outputCeiling.value = -3;

    See the sibling skill flutter-soloud-filters for filter details.

  • Fades/oscillations keep running on stopped handles. If a handle is stopped (or scheduleStop fires) mid-fade, the fader is not cancelled; when the same sound is played again and the handle id is recycled, the old ramp can snap the new voice's volume/pan. Reset the parameter explicitly (setVolume/setPan) when starting a new voice if you previously faded.

  • getVolume/getPan/getGlobalVolume round-trip through float. Reading back 0.8 can return 0.800000042353. Never compare with ==.

  • Handles die. After a sound ends or is stopped, the handle is invalid. setVolume on a dead handle fails silently on the native side; check getIsValidVoiceHandle(handle) if unsure. Don't cache handles across stop()/scheduleStop().

  • getApproximateVolume returns 0 forever if visualization was never enabled — it reads the same analysis buffers as the waveform/FFT feature.

  • setRelativePlaySpeed(handle, 0) is undefined behavior (likely crash); the lower bound is silently clamped to 0.05. Same applies to fadeRelativePlaySpeed / oscillateRelativePlaySpeed targets.

  • Max voice count is 16 by default. Extra play() calls steal the oldest voice of the same sound (or are dropped with a log warning — no exception), so a fade targeting the stolen handle does nothing. Raise with setMaxActiveVoiceCount if needed.

  • Fades are synchronous calls, not Futures. fadeVolume returns immediately; if you need to act when the fade finishes, await your own Future.delayed with the same duration.

More depth

  • Limiting and other filters: sibling skill flutter-soloud-filters; demo example/lib/filters/limiter.dart.
  • Bus-level volume (group many sounds under one fader): example/lib/mixing_bus/mixing_bus.dart.
  • Executable usage references: example/tests/tests/volume_controls.dart, example/tests/tests/pan.dart, example/tests/tests/advanced_pan.dart.

Keeping this skill current

This skill ships inside the flutter_soloud package, so upgrading flutter_soloud can carry a newer revision of it than the copy installed in the project. To check, run:

sh
dart run flutter_soloud:skills --check

It reports the installed and bundled skill versions and exits non-zero when an update is available. Offer to update with dart run flutter_soloud:skills (which touches only the skills, never pubspec or build files).

© alnitak, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/flutter-soloud-volume-pan of alnitak/flutter_soloud.

Open the folder on GitHubat commit 289697e

Compare with similar skills

Flutter Soloud Volume Pan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter Soloud Volume Pan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Soloud Volume Pan this skillalnitak/flutter_soloud425—~1.7kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Flutter Cherry Pickflutter/flutter179k—~1.8kAutomated safety check: PassBSD-3-Clause
Upgrade Browserflutter/flutter179k—~1.1kAutomated safety check: PassBSD-3-Clause
Bump Dartflutter/flutter179k—~1.2kAutomated safety check: PassBSD-3-Clause
Run Devicelab With Ledflutter/flutter179k—~786Automated safety check: PassBSD-3-Clause

Similar skills

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Flutter Cherry Pick

    flutter/flutter

    How to land a formal cherry-pick of a merged PR for the flutter/flutter repo stable or beta channel.

    179k GitHub stars~1.8k tokensUpdated today
    MobileAuto-check passed
  • Upgrade Browser

    flutter/flutter

    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests.

    179k GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed
  • Bump Dart

    flutter/flutter

    Do not trigger automatically; only run when a user runs /bump-dart.

    179k GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed
  • Run Devicelab With Led

    flutter/flutter

    Run DeviceLab tests for Flutter PRs using LUCI's led CLI tool.

    179k GitHub stars~786 tokensUpdated today
    MobileAuto-check passed
  • Shepherd PRs

    flutter/flutter

    Automate shepherding, checking status, updating branches, and landing open PRs or approved third-party contributor PRs in the flutter/flutter repository using the gh CLI.

    179k GitHub stars~1.7k tokensUpdated today
    MobileAuto-check passed

More from alnitak/flutter_soloud

All 14 skills in this repo
  • Flutter SoLoud Audio Filters

    alnitak/flutter_soloud

    Explains how to add and tune flutter_soloud's 13 audio filters at global, per-sound and mixing-bus level, including activation order and parameter fades.

    425 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • flutter_soloud Mixing Buses

    alnitak/flutter_soloud

    Teaches flutter_soloud mixing buses for routing groups of sounds through shared sub-mixes with collective volume and filters, such as separate music, SFX and UI sliders.

    425 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • flutter_soloud Setup

    alnitak/flutter_soloud

    Walks through adding the flutter_soloud audio engine to a Flutter app, with per-platform setup, initialization, binary-size and logging options, and output device switching.

    425 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check: notes
  • Teaches the push buffer-stream API of flutter_soloud for playing audio that arrives in chunks, such as icecast radio, WebSocket PCM feeds or streaming TTS, instead of a complete file.

    425 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Shows how to build audio visualizers in Flutter with flutter_soloud, using live FFT and wave data or offline waveform extraction, plus volume readings for level meters.

    425 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Flutter Soloud 3D Audio

    alnitak/flutter_soloud

    Teaches positional (3D) audio in fluttersoloud — play3d/play3dClocked/play3dScheduled, listener position/orientation/velocity, per-source attenuation and Doppler, and the per-frame update pattern.

    425 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

Works with

Categories

Questions about Flutter Soloud Volume Pan

What does Flutter Soloud Volume Pan do?

Teaches volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter…. Flutter Soloud Volume Pan is an agent skill from alnitak/flutter_soloud. Teaches volume, pan, fade, oscillator, and scheduled-stop control in the fluttersoloud package, including the handle-based model, setPanAbsolute, getApproximateVolume for VU meters, and the limiter filter as the anti-clipping tool.

When should I use Flutter Soloud Volume Pan?

Flutter Soloud Volume Pan fits situations like: the user asks to change a sounds volume; pan a sound left/right; oscillate audio parameters; build a VU meter.

How do I install Flutter Soloud Volume Pan in Claude Code?

Run `npx skills add alnitak/flutter_soloud --skill flutter-soloud-volume-pan -a claude-code`. Or copy the skill folder (skills/flutter-soloud-volume-pan in alnitak/flutter_soloud) into .claude/skills/flutter-soloud-volume-pan in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Soloud Volume Pan in Codex?

Run `npx skills add alnitak/flutter_soloud --skill flutter-soloud-volume-pan -a codex`. Or copy the skill folder (skills/flutter-soloud-volume-pan in alnitak/flutter_soloud) into .agents/skills/flutter-soloud-volume-pan in your project. Codex loads it when a task matches its description.

Can I use Flutter Soloud Volume Pan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alnitak/flutter_soloud --skill flutter-soloud-volume-pan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-soloud-volume-pan, .gemini/skills/flutter-soloud-volume-pan, .github/skills/flutter-soloud-volume-pan and .opencode/skills/flutter-soloud-volume-pan in your project.

What does Flutter Soloud Volume Pan need to run?

Going by SKILL.md and its folder, Flutter Soloud Volume Pan needs the command-line tools its instructions call (dart).

Does Flutter Soloud Volume Pan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter Soloud Volume Pan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter Soloud Volume Pan use?

Flutter Soloud Volume Pan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Soloud Volume Pan use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter Soloud Volume Pan?

Skills that share tags, products or a category with Flutter Soloud Volume Pan: Engine Whats New (flutter/flutter, 179k stars), Flutter Cherry Pick (flutter/flutter, 179k stars), Upgrade Browser (flutter/flutter, 179k stars) and Bump Dart (flutter/flutter, 179k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Soloud Volume Pan?

alnitak (a GitHub user) maintains it in alnitak/flutter_soloud, which has 425 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 6, 2026.

Source: alnitak/flutter_soloud on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.