audio-transcription-workflow

Convert audio files into structured markdown transcripts via multi-provider pipeline.

1|1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/valtterimelkko/agent-workflow-skills --skill audio-transcription-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-transcription-workflow
Source: https://github.com/valtterimelkko/agent-workflow-skills/tree/main/skills/audio-transcription-workflow
Command: npx skills add https://github.com/valtterimelkko/agent-workflow-skills --skill audio-transcription-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve?

This skill solves the friction of converting various audio formats into structured, cleaned markdown files, ensuring that voice notes and interviews are immediately ready for documentation or further AI analysis.

Core Features & Use Cases

  • Multi-Stage Processing: Uses local Whisper for primary transcription with an automatic OpenAI fallback and OpenRouter-based cleanup.
  • Batch Capability: Handles single files, folders, or glob patterns with recursive support to process large archives efficiently.
  • Use Case: Use this when you have a folder of interview recordings or voice notes that need to be turned into consistent, readable markdown files with metadata headers for easy tracking.

Quick Start

Use the audio-transcription-workflow skill to transcribe all audio files in the current directory and save the results as markdown files in the output folder.

Frequently Asked Questions about audio-transcription-workflow

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

FAQPage Schema
How do I batch transcribe audio files into markdown automatically?

Use the transcription workflow to process single files, folders, or recursive glob patterns, converting diverse audio formats into structured markdown transcripts with metadata headers for easy tracking.

Can I use local Whisper for audio transcription without sending data to the cloud?

Yes, local Whisper handles primary transcription, with an automatic OpenAI API fallback and OpenRouter-based post-transcription text refinement available for cleanup and formatting.

Do I need API keys to transcribe voice notes with this workflow?

Yes, you need local Whisper access for primary transcription, OpenAI API keys for fallback, and OpenRouter API keys for post-transcription text refinement and cleanup of voice notes.

What's the best way to convert interview recordings into readable documentation?

Process interview recordings through the multi-stage pipeline: local Whisper transcribes, OpenAI provides fallback, and OpenRouter cleans up the text into structured markdown files with metadata headers for research documentation.

Does this transcription workflow support recursive folder processing for large audio archives?

Yes, the workflow supports recursive folder processing and glob patterns, enabling efficient batch transcription of large audio archives into structured markdown transcripts with metadata headers.

Why does my audio transcription need AI cleanup after converting speech to text?

AI cleanup via OpenRouter refines raw speech-to-text output into structured markdown, ensuring voice notes and interview transcripts are immediately readable and ready for further documentation or AI analysis.