sumitaich1998/jarvisvr / skills/media/set-soundscape
set-soundscape
VerifiedPlay looping ambient soundscapes for focus, relaxation, or sleep — rain, café, forest, white noise — with an optional audio-reactive visualizer. Use for "play some rain sounds", "café ambience", "white noise to focus", or "ocean waves to sleep". Triggers: ambience, soundscape, background sounds, rain sounds, white noise, focus sounds, calm, nature sounds.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
SKILL.md
View on GitHub---
name: set-soundscape
description: >-
Play looping ambient soundscapes for focus, relaxation, or sleep — rain, café,
forest, white noise — with an optional audio-reactive visualizer. Use for "play
some rain sounds", "café ambience", "white noise to focus", or "ocean waves to
sleep". Triggers: ambience, soundscape, background sounds, rain sounds, white
noise, focus sounds, calm, nature sounds.
license: MIT
compatibility: >-
Requires JarvisVR agent-backend. Loops sample/ambient audio; live libraries use
the configured provider.
metadata:
agent: media-agent
category: media
version: "1.0"
author: jarvisvr
allowed-tools: play_media show_music_visualizer
---
# Set Soundscape
Create a calm, looping background atmosphere with a low-key visual. Distinct from
`control-media-playback` (foreground tracks) — soundscapes are ambient, looped,
and quiet by default.
## Steps
1. **Map the mood** to a soundscape (rain, café, forest, ocean, white/brown
noise, fireplace).
2. **Loop it** with `play_media` (`media_type:"audio"`, `loop:true`, gentle
`volume`). Keep the player unobtrusive.
3. **Add a subtle visual** with `show_music_visualizer` (`style:"wave"` or
`"particles"`) when the user wants something to look at.
4. **Pair with focus** — offer a Pomodoro (`productivity-agent`) for work
sessions, or a sleep timer (`manage-timers`) to fade out.
5. **Control** like any media (volume, stop) via the player's events.
## Output
Looping ambience (`play_media` → `media_player`):
```json
{ "widget_type": "media_player",
"transform": { "anchor": "world", "billboard": true },
"props": { "title": "Rain", "source_url": "https://cdn.jarvisvr.app/audio/rain.mp3",
"media_type": "audio", "state": "playing", "volume": 0.4, "loop": true } }
```
Calm visual (`show_music_visualizer`):
```json
{ "widget_type": "music_visualizer",
"props": { "track": "Rain", "style": "wave", "amplitude": [0.2,0.3,0.25,0.35,0.3],
"color": "#7FE7FF", "playing": true } }
```
`agent.speech`: `{ "text": "Rain sounds on, nice and low. Want a focus timer with that?", "final": true }`
## Edge cases
- **Too loud by default** → start quiet (≈0.4); soundscapes shouldn't startle.
- **Sleep request** → set a fade-out / stop via a `manage-timers` sleep timer.
- **Layering** → if a foreground track is already playing, ask before stacking
audio; usually replace rather than mix.
- **Named song, not ambience** → that's `control-media-playback`.
- **Battery/thermal** → a static loop is cheap; drop the visualizer if
`perception.state.thermal` is elevated.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |