# voiceover

The voiceover skill writes the demo narration before any code exists, then carries the feature through to a pull request with frame-by-frame proof attached. Useful when the team should agree on what a viewer sees first.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 7523 repo stars
- Author: Devin-AXIS
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/skills/voiceover/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/voiceover

## What it does

Flip the usual order: narration first, implementation after. The agent asks a few questions about the feature, then drafts the demo voice-over frame by frame — one numbered paragraph per screen, 4–8 of them for most features. You edit words instead of diffs until you would genuinely read it aloud. Nothing gets built before you sign off on the script.

On approval it creates a separate checkout with `git worktree add` from `origin/dev`, saves the script to `evals/voiceovers/<flow-id>.md`, and runs `pnpm fraimz scaffold <flow-id>` to generate `evals/flows/<flow-id>.flow.mjs` with a `ctx.prove` stub per paragraph. Renumbering or rewording paragraphs later needs a fresh approval, because a flow fails the check once its narration no longer matches the file.

The `executor` subagent writes the feature; the `fraimz` skill loop drives the demo against the running app, repairs what broke and re-runs until every frame passes. Shipping means `gh pr create` plus `pnpm fraimz --flow <flow-id> --pr`, which drops the per-frame evidence onto the pull request as a comment. You need `pnpm`, `gh` and `fraimz` installed, or phases three and four stall. The repository is proprietary-licensed, so check the terms before wiring it into a team repo.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill voiceover -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill voiceover -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill voiceover -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Devin-AXIS/iPolloWork .opencode/skills/voiceover
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill voiceover -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Devin-AXIS/iPolloWork --path .opencode/skills/voiceover
```

### Windsurf (Devin Desktop)

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

### 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/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/skills/voiceover/SKILL.md

## When to use it
- agree on a demo before anyone writes code
- rewrite narration until it sounds speakable
- scaffold a proof flow from the approved script
- drive the demo against the running app and fix what breaks
- attach per-frame evidence to the pull request

## Example prompts
- Write the voice-over for the CSV export feature, five frames.
- Run `/voiceover` and redo frame two — it describes the code instead of what the viewer sees.
- Scaffold the flow from the approved script and run it until every frame passes.

## Similar
- [om-auto-create-pr-loop](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr-loop.md) — skill · 4700 installs
- [om-auto-create-pr](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr.md) — skill · 4700 installs
- [review-pr](https://affpapa.org/en/nevibecode/skills/mikeyobrien-review-pr.md) — skill · ★ 3206 repo stars
- [wendy-iterating](https://affpapa.org/en/nevibecode/skills/wendy-iterating.md) — skill · ★ 64 repo stars
- [branch-finish](https://affpapa.org/en/nevibecode/skills/branch-finish.md) — skill · 2600 installs
- [resolve-pr-conflicts](https://affpapa.org/en/nevibecode/skills/resolve-pr-conflicts.md) — skill · 669 installs

From the same set: [devin-axis/ipollowork](https://affpapa.org/en/nevibecode/by/devin-axis/ipollowork.md) — 42 cards

---
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
