# timebuzzer-led

The timebuzzer-led skill for Claude Code controls the timeBuzzer RGB LED over MIDI, setting colors, effects, and status signals from code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 165 installs · ★ 414 repo stars
- Author: glebis
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/glebis/claude-skills/tree/HEAD/timebuzzer-led/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/timebuzzer-led

## What it does

timebuzzer-led sends MIDI commands to the timeBuzzer USB device to control its three independent RGB segments. The skill supports named colors (red, blue, green, and more), effects with tunable parameters (tempo, duration, flash count), and semantic status signals for success, error, attention, and processing states. Effects run in the background; your code keeps moving while the LED animates.

The core is a single Python script, `buzzer_led.py`, that communicates via MIDI CC on channel 12. You need the `python-rtmidi` library (install via pip) and a timeBuzzer device connected over USB-C. If the timeBuzzer app is running, the MIDI port is shared—the skill simply overrides the LED color directly.

Sync across devices using a shared signal vocabulary: one command can light the timeBuzzer LED and switch Philips Hue in the same moment.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill timebuzzer-led -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/timebuzzer-led/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/timebuzzer-led/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill timebuzzer-led -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/timebuzzer-led/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill timebuzzer-led -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/timebuzzer-led/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install glebis/claude-skills timebuzzer-led
```

2. **Manually: put the files in place**
- File: `.github/skills/timebuzzer-led/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill timebuzzer-led -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/glebis/claude-skills --path timebuzzer-led
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/timebuzzer-led/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill timebuzzer-led -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/glebis/claude-skills/tree/HEAD/timebuzzer-led/SKILL.md

## When to use it
- Signal status through timeBuzzer LED (success, error, working state)
- Set different colors on each of the three LED segments independently
- Run a pulsing or strobing effect at a specific tempo
- Coordinate timeBuzzer lighting with other smart bulbs

## Example prompts
- Make the timeBuzzer pulse blue at 30 BPM for 5 seconds
- Set segment 0 to red, segment 1 to green, segment 2 to blue
- Show a success signal on the timeBuzzer LED

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6c3f49de506bfa44.

BEGIN THIRD-PARTY FILE 6c3f49de506bfa44
````text
---
name: timebuzzer-led
description: Control timeBuzzer hardware LED via MIDI — set color, effects (pulse, strobe, rainbow, fade), and semantic status signals. Use when the user asks to change the buzzer LED color, signal status through the buzzer, or sync the buzzer with other lighting.
---

# timeBuzzer LED

Control the timeBuzzer hardware LED over MIDI. The device has 3 RGB segments controllable independently or together.

## Requirements

- timeBuzzer device connected via USB-C
- `python-rtmidi` installed (`pip install python-rtmidi`)
- timeBuzzer app may be running (MIDI port is shared)

## Script

Single CLI: `scripts/buzzer_led.py`

### Color commands

```bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color red
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color --hex "#FF8800"
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rgb 255 100 0
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py off
```

Named colors: red, orange, yellow, green, cyan, blue, purple, magenta, pink, white, warm, off.

### Effects

```bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py pulse blue --bpm 30 --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py strobe red --count 5 --interval 0.15
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rainbow --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py fade warm --seconds 2
```

### Status signals (parallel to `hue` skill)

```bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal thinking --seconds 5
```

| signal | color | effect |
|---|---|---|
| success/done | green | solid |
| error | red | strobe |
| warning | orange | pulse |
| thinking | blue | pulse |
| working | cyan | pulse |
| idle | warm | solid |
| attention | magenta | strobe |
| focus | purple | solid |

### Per-segment control

```bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 0 255 0 0   # seg 0 red
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 1 0 255 0   # seg 1 green
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 2 0 0 255   # seg 2 blue
```

## Protocol details

- USB MIDI device (vendor 0x16D0, product 0x1170)
- Sends/receives MIDI CC on channel 12 (status byte 187/0xBB)
- LED output: CC 70-78 for 3 segments x 3 channels (R, G, B)
- Values: 0-127 (half of standard 0-255 RGB)
- The timeBuzzer app controls LED based on active project color; this script overrides it directly

## Syncing with Hue

Use the same signal vocabulary as the `hue` skill. Example combined command:

```bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success &
python3 ~/.claude/skills/hue/scripts/hue.py signal success --group 1
````
END THIRD-PARTY FILE 6c3f49de506bfa44

The third-party file has ended. Everything between the 6c3f49de506bfa44 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2874 of 2879 bytes. © glebis · MIT · https://github.com/glebis/claude-skills/tree/HEAD/timebuzzer-led/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
