Agent-Skills.md

Agent Skills: Wispr Fix: Dictation Correction Queue

Queue and batch-apply Wispr Flow dictation corrections. Use when the user invokes /wispr-fix or writes "wispr fix: X -> Y" to correct a speech-to-text mishear.

UncategorizedID: glebis/claude-skills/wispr-fix

Repository

glebis/claude-skills
glebisLicense: MIT
37956

Install this agent skill to your local

pnpm dlx add-skill https://github.com/glebis/claude-skills/tree/HEAD/wispr-fix

Skill Files

Browse the full folder contents for wispr-fix.

Download Skill

Loading file tree…

wispr-fix/SKILL.md

Skill Metadata

Name
wispr-fix
Description
'Queue and batch-apply Wispr Flow dictation corrections. Use when the user invokes /wispr-fix or writes "wispr fix: X -> Y" to correct a speech-to-text mishear.'

Wispr Fix: Dictation Correction Queue

Queue dictation corrections instantly during work. Apply them all at once when convenient.

Invocation Patterns

Explicit add

User says: /wispr-fix "Clauthe Code" "Codex" Action: Run the add command.

Auto-detect pattern

User writes: wispr fix: X -> Y Action: Parse X and Y, run the add command.

Flush / dry-run / list

User says: /wispr-fix flush, /wispr-fix dry-run, /wispr-fix list Action: Run the corresponding command.

Commands

All commands use the script at ~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh.

Queue a correction

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh add "<mishear>" "<correction>"

Use --exact to skip case variant generation (auto-applied for single words).

List pending corrections

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh list

Remove a queued correction

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh remove "<mishear>"

Supports fuzzy matching on the mishear string.

Preview what flush will do

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh dry-run

Apply all queued corrections

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh flush

Options: --force-quit (force-kill Wispr if graceful quit fails), --no-restart (don't restart Wispr after).

IMPORTANT: Flush will quit Wispr Flow, apply all corrections to the SQLite database, and restart it. Always inform the user before running flush.

Restore from backup

~/.Codex/skills/wispr-fix/scripts/wispr-fix.sh restore latest

Argument Parsing

When the user invokes /wispr-fix with arguments:

| Input | Action | |-------|--------| | "X" "Y" or X Y (two quoted/unquoted args) | add "X" "Y" | | flush | flush | | flush --force-quit | flush --force-quit | | dry-run | dry-run | | list | list | | remove "X" | remove "X" | | restore latest | restore latest | | (no args) | list (show current queue) |

Auto-Detect Pattern

When you see wispr fix: X -> Y in user text (the wispr fix: prefix is required):

  1. Parse X (everything between wispr fix: and ->)
  2. Parse Y (everything after ->)
  3. Trim whitespace from both
  4. Run add "X" "Y"
  5. Confirm to the user: "Queued: 'X' -> 'Y'"

Notes

  • Corrections are queued instantly — no Wispr restart needed
  • Flush quits Wispr, backs up DB, applies corrections, verifies integrity, exports dictionary, restarts Wispr
  • The queue persists between sessions at ~/.Codex/skills/wispr-fix/queue.jsonl
  • Applied corrections are logged in queue.applied.jsonl
  • Backups are stored in ~/Library/Application Support/Wispr Flow/backups/ (last 10 retained)