Communitygithub.com

Hownameee/short-videos

生成、修订或排查本地 Kokoro 旁白、发音与场景词时间问题。复用已验证的未修改片段;在更改设置前检查 Python 环境。不涉及研究、视觉、音乐创作与发布。

short-videos 是什么?

该技能专注于为 AI 代理提供短格式视频的本地 Kokoro TTS(文本转语音)旁白生成、修订与问题排查能力。它确保旁白生成过程严格遵循既定流程,包括使用经批准的文本和共享生成器,而非项目特定的脚本,并强制保留预测的时间戳,避免使用估算的句子时间。该技能通过维持稳定的场景 ID 并仅在文本、发音、模型、语音或其他参数发生变化时重新合成片段,从而支持高效工作流;未修改的音频文件和已验证的清单将按位保留。它提供详细的验证工具,包括工作流预检,以检查单词覆盖范围、采样率、音频可解码性等,并指导用户审查输出音频是否存在缺失、重复或剪切的单词以及发音问题。脚本包含发音映射以规范化缩写、数字和 URL,同时强调保持源文本与口头文本之间的差异。该技能在类 Unix 系统上通过命令行运行,并可集成到如 Anthropic Claude Code 或 Cursor 等 AI 代理环境中,作为开发工作流的一部分。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/kokoro-tts

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Kokoro 旁白

使用经批准的文本和共享生成器;不要复制项目特定的 TTS 脚本,也不要将预测的时间戳替换为估算的句子时间。

.venv-kokoro/bin/python tools/kokoro/generate_audio.py --project projects/NNN-topic

该助手支持匹配美式/英式英语语音,采样率为 24 kHz。仅当需要安装、解决依赖失败或更改语言时才阅读设置与语言参考;请先检查解释器(interpreter/pyvenv.cfg)。在添加依赖前先询问。其他语言需要受支持的提供方或试听;切勿承诺通过英语音素实现原生越南语。

修订与复用

保持稳定的唯一场景 ID。生成器会检查文本/发音、模型、语音、语言、速度、采样率、包以及生成器/字幕代码版本、WAV 哈希/时长和单词/字幕覆盖率。仅合成无效的场景;未更改的 WAV 和时间戳将按位保留。旧的已验证清单可以采纳一次。完全未更改的运行也会保持清单不变。生成在所有结果就绪后才交换语音目录;失败时会保留之前的设置。不要对同一项目同时运行写入操作。

使用 --force 有意重新生成所有片段,包括在同一模型标识符下更改本地缓存模型权重之后(权重字节不在缓存键中)。新的模型/语音/速度会使每个受影响的片段失效。仅音乐修订不需要调用 TTS。

使用脚本的发音映射规范化缩写、数字和 URL。保留源文本与口头文本的区别;字幕遵循口头文本,除非另行对齐。每个意图表达只说出一次。标点符号不是时间保证。

在场景帧之前测量实际 WAV 时长。在增加速度之前,对密集场景进行缩短、扩展或拆分;绝不要裁剪语音以适配猜测的时长。如果需要,保留原始音频并创建单独的填充/重采样衍生文件。

验证

生成后运行工作流预检。要求完整的、有序的、范围内的单词,短语边界,正确的采样率,非空且可解码的音频以及已测量的时长。时间戳包含实际前序片段长度并附加标点。检查缺失/重复/裁剪的单词、发音、停顿、峰值和尾部空间。在可能的情况下进行试听;预测的对齐不是独立的转录。检查连续三个渲染的高亮片段和一个后续场景/片段,遵循默认值。记录未执行的试听。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

相关技能