screen-narrator

Live narration of your screen activity with 7 styles (sports, nature, horror, noir, reality_tv, asmr, wrestling) and live switching.

7 stars

byDemerzels-lab

View on GitHub Installation ↓

Best use case

screen-narrator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Live narration of your screen activity with 7 styles (sports, nature, horror, noir, reality_tv, asmr, wrestling) and live switching.

Teams using screen-narrator should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/narrator/SKILL.md --create-dirs "https://raw.githubusercontent.com/Demerzels-lab/elsamultiskillagent/main/public/skills/buddyh/narrator/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/narrator/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How screen-narrator Compares

Feature / Agent	screen-narrator	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Live narration of your screen activity with 7 styles (sports, nature, horror, noir, reality_tv, asmr, wrestling) and live switching.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Screen Narrator

Live screen narration via Gemini vision + ElevenLabs TTS. 7 styles with per-style voices and ambient tracks.

## Commands

### Start
```bash
tmux new-session -d -s narrator "cd {baseDir} && python -m narrator sports --control-file /tmp/narrator-ctl.json --status-file /tmp/narrator-status.json"
```

### Start with timer
```bash
tmux new-session -d -s narrator "cd {baseDir} && python -m narrator wrestling -t 5m --control-file /tmp/narrator-ctl.json --status-file /tmp/narrator-status.json"
```

### Change style
```bash
echo '{"command": "style", "value": "horror"}' > /tmp/narrator-ctl.json
```

### Change profanity
```bash
echo '{"command": "profanity", "value": "low"}' > /tmp/narrator-ctl.json
```

### Pause / Resume
```bash
echo '{"command": "pause"}' > /tmp/narrator-ctl.json
echo '{"command": "resume"}' > /tmp/narrator-ctl.json
```

### Multiple commands
```bash
echo '[{"command": "style", "value": "noir"}, {"command": "profanity", "value": "high"}]' > /tmp/narrator-ctl.json
```

### Check status
```bash
cat /tmp/narrator-status.json
```

### Stop
```bash
tmux kill-session -t narrator
```

## Styles

| Style | Vibe |
|---|---|
| `sports` | Punchy play-by-play announcer |
| `nature` | David Attenborough documentary |
| `horror` | Creeping dread, ominous foreshadowing |
| `noir` | Hard-boiled detective narration |
| `reality_tv` | Reality TV confessional booth |
| `asmr` | Whispered meditation |
| `wrestling` | BAH GAWD maximum hype announcer |

## Control commands

| Command | Value | Example |
|---|---|---|
| `style` | Style name | `{"command": "style", "value": "wrestling"}` |
| `profanity` | `off`, `low`, `high` | `{"command": "profanity", "value": "low"}` |
| `pause` | (none) | `{"command": "pause"}` |
| `resume` | (none) | `{"command": "resume"}` |

## Common requests

- "narrate my screen" / "roast my screen" -> Start with `sports`
- "haunt my screen" -> Start with `horror`
- "narrate for 5 minutes" -> Use `-t 5m`
- "switch to wrestling" -> Write style command to control file
- "make it family friendly" -> Set profanity to `off`
- "pause" / "shut up" -> Pause command
- "stop narrating" -> `tmux kill-session -t narrator`