scriptor

Transcribes audio and video files into structured meeting protocols using Gemini or OpenAI models.

Updated Nov 21, 2025
One-click install
npx skills add https://github.com/alatyshau/duet --skill scriptor-alatyshau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scriptor
Source: https://github.com/alatyshau/duet/tree/main/packages/skills/tools/scriptor
Command: npx skills add https://github.com/alatyshau/duet --skill scriptor-alatyshau

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-genai, openai.

What problem does it solve? Converting long audio or video recordings into accurate, structured meeting transcripts is tedious and error-prone, especially with domain-specific terminology and multiple speakers. This Skill automates the full pipeline from media file to final protocol while keeping the user in control at key review points. ## Core Features & Use Cases - Multi-model transcription: Supports Gemini (gemini-2.5-pro, gemini-2.5-flash) and OpenAI (gpt-4o-audio-preview, gpt-4o-transcribe) models with custom glossaries to improve recognition of domain terms. - Chunked processing with caching: Splits long recordings into 20-minute overlapping chunks via ffmpeg, transcribes each, aligns speaker labels across chunks, and resumes from where it stopped on re-runs. - Interactive post-processing: Thematic segmentation, terminology audit with user-approved corrections, participant identification, and final assembly into a structured transcript.md. - Use Case: You have a 90-minute meeting recording in Russian with technical jargon. The Skill converts it to mp3, transcribes it chunk by chunk with your glossary, lets you fix misrecognized terms, and produces a segmented protocol with a participants list. ## Quick Start Ask the agent to transcribe your recording by saying: transcribe the file meeting-2024-06-01.mp4 using my project glossary with gemini-2.5-pro.

Frequently Asked Questions about scriptor

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

FAQPage Schema
How do I transcribe a long audio recording with Gemini?

Convert the file to mono 16kHz mp3 with ffmpeg, split it into 20-minute chunks with 30-second overlap, then run the transcribe_chunk.py script per chunk with your prompt and glossary. The Skill automates this entire sequence and merges results.

Gemini vs OpenAI for audio transcription, which should I use?

Gemini models (gemini-2.5-pro, gemini-2.5-flash) accept a full prompt plus glossary for guided transcription. OpenAI offers gpt-4o-audio-preview with prompt support and gpt-4o-transcribe, an ASR model that only uses the glossary as a hint.

Can I resume an interrupted transcription pipeline?

Yes, every step caches its output files. On re-run the pipeline skips existing audio.mp3, chunks, raw transcripts, and merged files, continuing from where it stopped. Saying start over clears the output directory for a full restart.

How do I improve recognition of domain-specific terms in transcription?

Provide a glossary file that is passed to the transcription model with each chunk. After transcription, the terminology audit step flags suspicious words, and approved corrections are appended to the glossary for future runs.

Why does transcription fail with API errors?

Failures usually come from missing API keys in the .env file, rate limits, or files too large for the model. The pipeline retries up to 3 times with increasing pauses and suggests reducing chunk duration for oversized files.