---
name: voice-refine
description: "Transform verbose voice input into structured, token-efficient Claude prompts. Use when cleaning up voice memos, dictation output, or speech-to-text transcriptions that contain filler words, repetitions, and unstructured thoughts."
allowed-tools: Read
effort: low
---

# Voice refine skill

Transform verbose, stream-of-consciousness voice dictation into structured,
token-efficient prompts for Claude Code.

## When to use

- Input from voice dictation (Wispr Flow, Superwhisper, macOS Dictation)
- Verbose text >150 words
- Contains filler words, repetitions, or tangents
- Natural speech patterns that need structure

## Transformation pipeline

```
1. DEDUPE    → Remove repetitions and filler words
2. EXTRACT   → Identify core requirements and constraints
3. STRUCTURE → Organize into standard sections
4. COMPRESS  → Reduce to ~30% of original while preserving intent
```

## Output format

```markdown
## Contexte
[Project context, existing stack, relevant files]

## Objectif
[Single sentence: what needs to be built/changed]

## Contraintes
- [Constraint 1]
- [Constraint 2]
- [etc.]

## Output attendu
[Expected deliverables: files, format, tests]
```

## Flags

| Flag | Effect |
|------|--------|
| `--confirm` | Show refined prompt before sending to Claude (default) |
| `--direct` | Send refined prompt directly without confirmation |
| `--verbose` | Keep more detail, less compression |
| `--en` | Output in English (default: matches input language) |

## Usage examples

### Basic usage

```
/voice-refine

Alors euh j'aimerais que tu m'aides à faire un truc, en fait j'ai une API
qui renvoie des données utilisateurs et je voudrais les afficher dans un
tableau React, mais attention il faut que ça soit paginé parce que y'a
beaucoup de données, genre des milliers d'utilisateurs, et aussi faudrait
pouvoir trier par nom ou par date d'inscription, ah et on utilise Tailwind
dans le projet donc faut que ça matche avec ça...
```

### With flags

```
/voice-refine --direct --en

[voice input in any language → sends English prompt directly]
```

## Compression metrics

| Metric | Target |
|--------|--------|
| Token reduction | 60-70% |
| Information retention | >95% |
| Structure clarity | High |

## Filtering rules

**Remove**: filler words ("euh", "um", "like", "basically"), repetitions, tangents, hedging ("maybe", "probably" unless relevant), politeness padding ("please", "could you").

**Preserve**: technical requirements, constraints, existing code context, expected output format, edge cases, business logic rules.

## See also

- `guide/ecosystem/ai-ecosystem.md` - Voice-to-Text Tools section
- `examples/before-after.md` - Full transformation examples


---
Source attribution: FlorianBruniaux
Original project: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Gabriel Moreira

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: FlorianBruniaux
Original project: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
Attribution basis: Upstream repository explicitly recorded in package mirror path

Fields of work: Content & Media, Design, Marketing, Product Management
Roles: Content Marketer, Copywriter, Product Manager, Technical Writer, UX Writer
Specialties: API, Word Documents, Frontend, React, Testing
Tools: Macos Dictation, Superwhisper, Wispr Flow
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 3315c32229c17f912915447d61fae3c602e65ae4278221847cea41e4262f50dd