add-voice-transcription

Transcribe WhatsApp voice notes into text using OpenAI's Whisper API.

3|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/OfirGavish/NinjaClaw-Nano --skill add-voice-transcription-ofirgavish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-voice-transcription
Source: https://github.com/OfirGavish/NinjaClaw-Nano/tree/main/.copilot/skills/add-voice-transcription
Command: npx skills add https://github.com/OfirGavish/NinjaClaw-Nano --skill add-voice-transcription-ofirgavish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill adds automatic voice message transcription to NinjaClaw's WhatsApp channel by leveraging OpenAI's Whisper API. It downloads, transcribes, and delivers the transcript to the agent as [Voice: <transcript>], enabling quicker comprehension of voice notes.

Core Features & Use Cases

  • Transcribe WhatsApp voice messages using Whisper and present the transcript to the agent as a structured cue like [Voice: <transcript>].
  • Integrate seamlessly with NinjaClaw's WhatsApp channel, enabling real-time voice-to-text workflows for conversations.
  • Supports a phased workflow including pre-flight checks, code changes application, API key configuration, environment syncing, and validation.

Quick Start

Install and configure an OpenAI Whisper API key, merge the WhatsApp skill, and run the agent to enable voice transcription.

Frequently Asked Questions about add-voice-transcription

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe WhatsApp voice messages into text for my agent?

To transcribe WhatsApp voice messages into text, this skill uses OpenAI's Whisper API to download audio files and deliver the transcript to the agent as a structured cue like [Voice: <transcript>].

Do I need an OpenAI API key to enable voice transcription?

Yes, you need an OpenAI API key to enable voice transcription. The skill requires configuring the OPENAI_API_KEY environment variable and integrating changes to the whatsapp.ts and transcription.ts files.

How does Whisper handle voice-to-text workflows in NinjaClaw?

Whisper handles voice-to-text workflows in NinjaClaw by processing WhatsApp voice notes through a phased setup including pre-flight checks, code application, API key configuration, and validation to deliver real-time transcripts.

Can I use this voice transcription skill without modifying my WhatsApp channel integration?

No, you cannot use this voice transcription skill without modifying your integration. It requires specific changes to src/channels/whatsapp.ts and src/transcription.ts, along with test coverage, to function properly.

What is the best way to automate voice message comprehension for WhatsApp channels?

The best way to automate voice message comprehension for WhatsApp channels is leveraging the Whisper API to automatically transcribe audio notes into readable text, enabling quicker comprehension without manual playback.