agentleFS
espressifespressif/esp-claw-skills-lab/skills/network_radio/SKILL.md

network_radio

Skill37 starsChanged 33 days agoMITView on GitHub

Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station. Always call the synchronous control script. It starts and controls a background radio player daemon when needed. Do not call the daemon script directly. 电台通过 audio.open_output() 使用固件提供的默认音频输出,不再接受 codec_name。需要可用的扬声器设备和网络。 Play 上海经典947: Switch to 杭州90.7 without changing volume: Set volume to 35 without restarting playback: Play a direct stream URL: Query current status: Stop the radio:

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 3 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station.

    line 18
  2. Distinctive:

    Always call the synchronous control script.

    line 20
  3. Distinctive:

    If no close match exists and the user did not provide a URL, ask the user to choose a station.

    line 167
  4. Very specific:

    Always run {CUR_SKILL_DIR}/scripts/control_network_radio.lua with lua_run_script and timeout_ms: 12000.

    line 168
  5. Very specific:

    Use action: "play" when starting radio from idle or when the user simply says to play a station.

    line 169
  6. Very specific:

    Use action: "switch" when the user asks to change station while radio may already be playing.

    line 170
  7. Very specific:

    Use action: "volume" when the user asks to set, raise, lower, or adjust volume.

    line 171
  8. Very specific:

    Use action: "status" when the user asks what is playing or current volume.

    line 172
  9. Very specific:

    Use action: "stop" when the user asks to stop, pause, cancel, quit, close, or turn off the radio.

    line 173

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “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

Network Radio

Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station.

Always call the synchronous control script. It starts and controls a background radio player daemon when needed. Do not call the daemon script directly.

电台通过 audio.open_output() 使用固件提供的默认音频输出,不再接受 codec_name。需要可用的扬声器设备和网络。

Available Stations

  • 崂山921
  • 长沙101.7城市之声
  • 上海经典947
  • 湖北经典音乐广播
  • 成都年代音乐怀旧好声音
  • 山东经典音乐广播
  • 杭州90.7
  • 天津TIKI 100.5

Control Args Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": ["play", "switch", "volume", "stop", "status"],
      "default": "status"
    },
    "station": {
      "type": "string",
      "description": "Station title or a distinctive title fragment. Use one of the available station names unless the user provides a direct URL."
    },
    "url": {
      "type": "string",
      "description": "Optional direct http or https MP3 stream URL. If set, it overrides station."
    },
    "title": {
      "type": "string",
      "description": "Display title used when url is provided directly."
    },
    "volume": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "wait_ms": {
      "type": "integer",
      "default": 8000,
      "minimum": 1000
    }
  },
  "required": ["action"]
}

Tool Call Inputs

Play 上海经典947:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "play",
    "station": "上海经典947",
    "volume": 70
  },
  "timeout_ms": 12000
}

Switch to 杭州90.7 without changing volume:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "switch",
    "station": "杭州90.7"
  },
  "timeout_ms": 12000
}

Set volume to 35 without restarting playback:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "volume",
    "volume": 35
  },
  "timeout_ms": 12000
}

Play a direct stream URL:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "play",
    "title": "自定义电台",
    "url": "http://example.com/live.mp3",
    "volume": 70
  },
  "timeout_ms": 12000
}

Query current status:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "status"
  },
  "timeout_ms": 12000
}

Stop the radio:

{
  "path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
  "args": {
    "action": "stop"
  },
  "timeout_ms": 12000
}

Behavior

  • play starts the background daemon when needed, opens audio_dac, and plays the selected station.
  • switch reuses the daemon, stops the current stream, and starts the new station.
  • volume calls output:set_volume() in the daemon and does not restart playback.
  • status reads the last daemon status and does not start playback.
  • stop sends a stop command to the daemon; the daemon stops playback, closes audio resources, records the radio as stopped, and exits.
  • The daemon job name is network_radio_player and its exclusive group is audio_output.
  • Runtime commands use thread.sync queues named network_radio_cmd and network_radio_reply; the last status snapshot is stored under the DATA root as network_radio/status.json, resolved with storage.get_root_dir().

Recommended Flow

  1. For play or switch requests, choose the closest station from Available Stations.
  2. If no close match exists and the user did not provide a URL, ask the user to choose a station.
  3. Always run {CUR_SKILL_DIR}/scripts/control_network_radio.lua with lua_run_script and timeout_ms: 12000.
  4. Use action: "play" when starting radio from idle or when the user simply says to play a station.
  5. Use action: "switch" when the user asks to change station while radio may already be playing.
  6. Use action: "volume" when the user asks to set, raise, lower, or adjust volume. Pass an absolute volume value from 0 to 100.
  7. Use action: "status" when the user asks what is playing or current volume.
  8. Use action: "stop" when the user asks to stop, pause, cancel, quit, close, or turn off the radio.
  9. Report the script output directly. If the script returns an error, report that error directly to the user.

可选触摸界面

用户要求屏幕控制时,用 lua_run_script_async 启动 {CUR_SKILL_DIR}/scripts/network_radio_app.lua,指定 name: "network_radio_ui"、exclusive: "display"、replace: false、timeout_ms: 0。界面通过当前 lvgl.init(options) 自动接入显示和触摸;播放器仍为独立后台任务。只有用户明确要求替换显示任务时才允许 replace: true。

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.