yichen-volc-asr

Transcribe audio and video with Volcengine ASR and auto rough-cut talking-head footage.

2.0k|274|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mcncarl/yichen-skills --skill yichen-volc-asr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yichen-volc-asr
Source: https://github.com/mcncarl/yichen-skills/tree/main/yichen-volc-asr
Command: npx skills add https://github.com/mcncarl/yichen-skills --skill yichen-volc-asr

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Manually transcribing talking-head videos and cutting out filler words, repetitions, and long pauses is slow and error-prone. This Skill automates speech-to-text with timestamps and produces a rough-cut MP4 plus SRT subtitles ready for final editing in Jianying/CapCut.

Core Features & Use Cases

  • Speech-to-Text Transcription: Submits local audio/video files to Volcengine ASR via TOS upload and returns full text with per-segment timestamps, cached for reuse.
  • Automatic Rough Cutting: Detects silence gaps, pure filler words, adjacent repeated sentences, and redundant prefix words, then renders a trimmed MP4 with ffmpeg using smart margins and smoothing.
  • Subtitle Generation: Produces an SRT subtitle file aligned to the kept segments for direct import into Jianying.
  • Use Case: You record a 20-minute talking-head video with stumbles and retakes. Run the script on a working copy to get a cleaned rough cut, an SRT file, and a keep/delete plan, then hand it off for final polish.

Quick Start

Ask the assistant to transcribe and rough-cut your video by saying: help me transcribe this video and auto-cut the filler words, repetitions, and pauses into a rough-cut MP4 with subtitles.

Frequently Asked Questions about yichen-volc-asr

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

FAQPage Schema
How do I transcribe a video to text with timestamps using Volcengine ASR?

Run the transcribe.py script on a working copy of your video with the --no-execute flag. It uploads the file to TOS, submits a Volcengine ASR bigmodel task, and saves full text with per-segment timestamps plus a reusable cache file.

How to automatically cut filler words and pauses from talking-head videos?

The script detects pure filler segments, silence gaps over one second, and adjacent repeated sentences using difflib similarity, then renders a trimmed MP4 with ffmpeg trim and concat filters. Smart margins and smoothing prevent clipped words and flickering frames.

What environment variables does Volcengine ASR transcription require?

You need TOS_ACCESS_KEY, TOS_SECRET_KEY, and TOS_BUCKET for upload, plus VOLC_ASR_TRIAL_APP_ID and VOLC_ASR_TRIAL_TOKEN for the trial app. Paid usage requires VOLC_ASR_PAID_APP_ID and VOLC_ASR_PAID_TOKEN after marking the trial exhausted.

Does the script avoid double-billing when an ASR task is interrupted?

Yes. After submission it writes an asr_pending.json file with the request_id, and reruns resume the pending query instead of resubmitting. Only passing --force-new uploads and submits a new task.

Can I get subtitles for Jianying or CapCut from the transcription?

Yes. The script generates an SRT subtitle file from the kept segments with standard HH:MM:SS,mmm timestamps, which imports directly into Jianying or CapCut alongside the rough-cut MP4.