audio-transcribe

Transcribes audio files and voice notes to text via Gemini 2.5-flash. Integrates with Slack, Discord, and Telegram bridges so voice clips surface as readable text in tasks.

Jump to install

Repository: sonichi/sutando
Last source activity: July 17, 2026 at 14:46
Detected SKILL.md language: English
Stars: 388
Forks: 85

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/sonichi/sutando --skill audio-transcribe

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

audio-transcribe

Transcribes audio files (voice notes, clips) to text via Gemini 2.5-flash. Used by the Slack, Discord, and Telegram bridges to surface voice-note content in task bodies so the core agent can act on the words instead of a bare file path.

How it works

skills/audio-transcribe/scripts/transcribe.py <audio_file_path>

Reads the file, sends it inline (base64) to the Gemini 2.5-flash generateContent endpoint, and prints the transcript to stdout. Exits 0 on success, 1 on any failure (unsupported format, missing API key, network error, API error).

Fail-open design. Every bridge wraps the call in a helper that returns None on a non-zero exit. A failed transcription never blocks the task — the [File attached: /path] line still goes through so the agent can at least see a file was sent.

Supported formats

.m4a (Slack voice clips), .mp3, .ogg, .oga, .opus, .wav, .webm, .aac, .flac, .mp4

Key resolution order

GEMINI_API_KEY or GOOGLE_API_KEY in the process environment

<workspace>/.env (resolved via resolve_workspace())

$CLAUDE_CONFIG_DIR/channels/slack/.env

$CLAUDE_CONFIG_DIR/channels/discord/.env

$CLAUDE_CONFIG_DIR/channels/telegram/.env

Bridge integration

Each bridge calls _transcribe_via_skill(local_path) after downloading a file. The helper locates the skill script relative to src/ (or the app bundle), runs it, and returns the transcript string or None. The bridge then appends either:

[Voice transcript: <text>] — when transcription succeeds

[File attached: /path] — when skill is absent or transcription fails

Removing the skill

Delete skills/audio-transcribe/ — all three bridges fall back to [File attached:] automatically. Core services are unaffected.

name	audio-transcribe
description	Transcribes audio files and voice notes to text via Gemini 2.5-flash. Integrates with Slack, Discord, and Telegram bridges so voice clips surface as readable text in tasks.