Narrator
Live narration of your macOS screen activity with Gemini vision + ElevenLabs speech. Skill: Narrator Owner: buddyh Summary: Live narration of your macOS screen activity with Gemini vision + ElevenLabs speech. Tags: latest:1.3.2 Version history: v1.3.2 | 2026-02-16T21:55:08.694Z | user Make clawd narrator skill wrappers always delegate to the canonical /Users/buddy/narrator pipeline (real implementation); remove prototype-side execution paths. v1.3.1 | 2026-02-16T21:54:27.269Z | user Align skill docs
Rank
62
Safety
84
Downloads
1.8k
Updated
Oct 10, 2026
Version
1.3.2
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.8K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.3.2release · observed Feb 16, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17cwb3h7pssc8132cnbgm8gmx882623:narrator- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-buddyh-narrator/snapshot"
Documentation
CLAWHUB
13,587 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: screen-narrator
description: Live narration of your macOS screen activity with Gemini vision + ElevenLabs speech.
homepage: https://github.com/buddyh/narrator
metadata:
{
"openclaw":
{
"emoji": "🎙️",
"requires": {
"bins": ["python3", "tmux", "peekaboo"],
"env": ["GEMINI_API_KEY", "ELEVENLABS_API_KEY"]
},
},
}
---
# Screen Narrator
This skill maps to the upstream `narrator` repo implementation.
It runs Gemini-vision narration styles (sports, nature, horror, noir, reality_tv, asmr, wrestling) and ElevenLabs TTS, with optional dual-lane narration and live control via JSON files.
## Source of truth
Use the repo install:
```bash
cd /Users/buddy/narrator
/Users/buddy/narrator/.venv/bin/python -m narrator sports --help
```
## Setup
```bash
cd /Users/buddy/narrator
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```
Required environment:
- `GEMINI_API_KEY`
- `ELEVENLABS_API_KEY`
- optional: `ELEVENLABS_VOICE_ID`
## Runtime control commands
Start live narration in a tmux session (preferred):
```bash
tmux new-session -d -s narrator "cd /Users/buddy/narrator && /Users/buddy/narrator/.venv/bin/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 /Users/buddy/narrator && /Users/buddy/narrator/.venv/bin/python -m narrator wrestling --time 5m --control-file /tmp/narrator-ctl.json --status-file /tmp/narrator-status.json"
```
Change style on the fly:
```bash
echo '{"command": "style", "value": "horror"}' > /tmp/narrator-ctl.json
```
Set 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
```
Stop:
```bash
tmux kill-session -t narrator
```
Check status:
```bash
cat /tmp/narrator-status.json
```
## Notes
- macOS only (screen capture + TTS/audio).
- This OpenClaw skill wrapper is aligned to the `/Users/buddy/narrator` implementation to avoid drift between docs and runtime._meta.json
{
"ownerId": "kn77504adrn3e02cekr5mstanh7yknfx",
"slug": "narrator",
"version": "1.3.2",
"publishedAt": 1771278908694
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/buddyh/skills/narrator",
"sourceUrl": "https://clawhub.ai/buddyh/skills/narrator",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T01:47:03.642Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-buddyh-narrator/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-buddyh-narrator/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T01:47:03.642Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.8K downloads",
"href": "https://clawhub.ai/buddyh/narrator",
"sourceUrl": "https://clawhub.ai/buddyh/narrator",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T01:47:03.642Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.2",
"href": "https://clawhub.ai/buddyh/narrator",
"sourceUrl": "https://clawhub.ai/buddyh/narrator",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-16T21:55:08.694Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-buddyh-narrator/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-buddyh-narrator/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.2",
"description": "Make clawd narrator skill wrappers always delegate to the canonical /Users/buddy/narrator pipeline (real implementation); remove prototype-side execution paths.",
"href": "https://clawhub.ai/buddyh/narrator",
"sourceUrl": "https://clawhub.ai/buddyh/narrator",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-16T21:55:08.694Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
