transcription
GitHub用于处理音视频转录、字幕生成及文本修复。涵盖资产状态检查、进度监控、转录结果查找、字幕样式设置，以及针对失败或卡住的转录任务的重试和源文本修复流程。
Trigger Scenarios
Install
npx skills add ChatCut-Inc/agent-plugin --skill transcription -g -y
SKILL.md
Frontmatter
{
"name": "transcription",
"description": "Use for ChatCut transcription, transcript readiness, captions, subtitles, transcript repair, filler removal, and speech-led editing setup."
}
Transcription
- Use
browse_assetsto identify the video/audio asset and its transcription state. - For newly imported local media, complete the
asset-importworkflow first. - Check
track_progresswith targettranscription. It returns current status; follow the returned check-back guidance and do not busy-loop. - Use
find_transcriptfor timestamped text lookup. - Use the current caption tools to enable, inspect, translate, or style captions only after transcription is ready.
Do not call a transcription stuck from one pending status. Treat an explicit failed terminal state immediately; otherwise allow at least max(5 minutes, min(60 minutes, 2 x asset duration)), or at least 10 minutes across multiple checks when duration is unknown.
no_audio / no-speech is a successful terminal analysis result: the media is usable, but there is no transcript to read or caption. Do not report it as a transcription failure or retry it unless the user says the media contains speech that should have been detected.
When a run is genuinely failed or stuck, call manage_transcript with action:"retry_transcription" and the asset id, then check transcription progress again. Repair source words with the transcript-fix action instead of rewriting visible captions when the source transcript itself is wrong.
For semantic speech edits, load talking-head-guide and use the Script workflow. Use mechanical cleanup only for fixed fillers and pauses; do not replace transcript-aware editing with destructive physical timeline cuts.
Version History
-
926f56b
Current 2026-08-12 11:06
更新内容：移除了对显式失败状态的立即处理逻辑，增加了 `no_audio` 作为成功终态的处理说明，细化了重试和修复的操作指引。
-
e1867a8
2026-08-02 23:36
重构了流程步骤，明确区分新导入媒体与现有资产的转录准备；细化了等待时间计算逻辑（基于资产时长）；新增对语义语音编辑和机械清理的指导；优化了故障重试策略。
-
f39cdae
2026-07-30 21:53
更新获取资产ID的方法，由read_project改为browse_assets；优化本地资源处理指引，明确通过asset-import技能重新导入或先下载再导入，避免手动重链。
- 5e9afe0 2026-07-22 10:58
