Skip to content
Skills Library
Personal productivity · Conversion & formats

voice-note

/voice-note

Transcribe a local voice note (a WhatsApp .ogg or similar) with local Whisper, write the transcript next to the audio, then anonymize it by hand. Use when a MIP, an issue or a task needs the words of a voice note.

Repository
skills ↗
Licence
MPL-2.0
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MPL-2.0, otwarta.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/transcribe.py

What it does and when to use it

Transcribe a local voice note (a WhatsApp .ogg or similar) with local Whisper, write the transcript next to the audio, then anonymize it by hand. Use when a MIP, an issue or a task needs the words of a voice note.

Original author description

Transcribe a local voice note (a WhatsApp .ogg or similar) with local Whisper, write the transcript next to the audio, then anonymize it by hand. Use when a MIP, an issue or a task needs the words of a voice note.

How it works

  1. Run it
  2. After the transcript
  3. Never
Original SKILL.md headings · 41 lines, 291 words
SKILL.md preview
---
name: voice-note
description: "Transcribe a local voice note (a WhatsApp .ogg or similar) with local Whisper, write the transcript next to the audio, then anonymize it by hand. Use when a MIP, an issue or a task needs the words of a voice note."
---

# voice-note

Transcribe one local audio file with a local Whisper backend. No network call, no upload, no
external speech service. The skill does one thing: speech to text in the source language.

## Run it

```bash
python3 scripts/transcribe.py <audio> [--model small] [--language pt]
python3 scripts/transcribe.py --self-test
```

The path is relative to this skill folder.

- It tries `faster_whisper` first, then `whisper`. With neither, it stops with exit code 2 and
  an install hint.
- `--model small` is the default. Use `medium` or `large` only when `small` gets names or numbers
  wrong.
- Always set `--language`. Automatic detection often fails on a short, noisy note.
- The output is `<audio>.txt` next to the audio. The script prints only that path.

Install a backend in the project's own environment, not globally: `pip install faster-whisper`.

## After the transcript

1. **Read it.** Correct the words that Whisper heard wrong.
2. **Anonymize it by hand.** Replace each name, except the owner's, with a neutral word such as
   "a collaborator". A script cannot tell a name from a common word. Do it by reading.
3. **Translate it yourself** if necessary, as a second step. Do not use Whisper's translate mode.
   It hides which error occurred: a word heard wrong, or a word translated wrong.
4. Then use the text: a `triage` draft, a `mip`, or a note.

## Never

- **Never commit the audio.** A voice note is personal data. Keep it outside the work tree, or
  ignored by git. Delete it when the transcript is correct.
- Never commit a transcript before it is anonymized.
- Never turn a voice note into a merged feature in one pass. A voice note starts a design. It
  does not replace the review of a MIP.
Files in this package (2)
  • SKILL.md 2 KB
  • scripts/transcribe.py 4 KB

Versions

The database has no other skills named voice-note.

Database snapshot: 13.11.2026 · package version 8aba437edd33 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100whatsapp-voice
    Transcribe WhatsApp voice messages using local Whisper CLI. Use when: owner or contact sends an audio/ogg voice message. Combines Whisper transcription + CRM update + task creation. Works offline for short clips, uses OpenAI API for long clips. Hebrew and English supported.
  • 95transcribing-slack-audio
    Transcribe a Slack voice message or audio attachment (M4A, MP3, OGG/Opus, WAV, WebM) on the local machine with ffmpeg and whisper.cpp, so the agent can act on what the user said. Use when a Slack message carries an audio file, the prompt names Slack audio attachments, or the…
  • 100voice-memo-cleanup
    Turns a rambling voice memo transcript into a clean note that keeps the speaker's voice and every idea, and lists anything that sounded like a task. Use when someone pastes a voice memo, dictation, or speech-to-text transcript and wants it readable, or says "clean up this…
  • 82transcribe
    Transcribe audio or video on the user's own computer with local Whisper (faster-whisper): plain transcript, SRT and VTT captions, and word timestamps. English, Hindi and Hinglish. No API key, nothing uploaded. Use for "transcribe this", "make captions", "subtitles for this video".
  • 100use-local-whisper
    Use when the user wants local voice transcription instead of OpenAI Whisper API. Switches to whisper.cpp running on Apple Silicon. WhatsApp only for now. Requires voice-transcription skill to be applied first.
  • 100transcribe
    Transcribe an audio recording (m4a/mp3/wav/ogg/flac) to markdown locally with whisper.cpp. Auto-detects language (multilingual, tuned for EN/FR), CPU-only, private — no API, no GPU. Self-bootstrapping: builds the pipeline on first use if missing. Use when the user wants to…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.