Agent skill

Cs Narration Phrase Timeline

by ChenShuo2004 in ChenShuo2004/cs-skills

A skill your agent uses when the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or…

MITAuto-check passedMedia & Creative

Install Cs Narration Phrase Timeline

skills CLI
$ npx skills add ChenShuo2004/cs-skills --skill cs-narration-phrase-timeline -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ChenShuo2004/cs-skills cs-narration-phrase-timeline --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ChenShuo2004/cs-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cs-narration-phrase-timeline .claude/skills/cs-narration-phrase-timeline && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cs-narration-phrase-timeline
GitHub stars
197
Token cost
~500 tokens
SKILL.md length
79 words
Files
3 (incl. references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or…

  • Works in 5 steps: 先找已有产物。 如果项目任务目录已经有… → 选择正确入口。… → 验证实现,不猜命令。… → …
  • The user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json
  • SKILL.md covers 目标与边界, 输入与交付, 工作流 and 结果使用, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cs Narration Phrase Timeline is an agent skill from ChenShuo2004/cs-skills. Use when the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or narration-driven infographic and motion-graphics timing. Requires the final narration audio and the exact spoken copy; do not use for estimated timing, generic editing, or MP4 rendering.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/schema.md`).

It sits in Media & Creative, covering Text to speech and voice, Speech recognition and synthesis and Motion graphics. The repository describes itself as: 陈硕的 Codex Skills 与 AI 工作流手册:把产品、内容、调研与交付沉淀为可复用的智能工作流。 The licence is MIT.

When your agent uses it

  • The user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json
  • Whisper word-boundary alignment
  • Narration-driven infographic and motion-graphics timing
  • Estimated timing

Example prompts

  • “/cs-narration-phrase-timeline”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 先找已有产物。 如果项目任务目录已经有 phrase-timeline.json,先检查它是否来自最终音频且符合结构;核对音频与稿件的哈希或等效来源记录以及目标帧率;一致且有效时直接复用,避免重新识别。仅文件名相同不足以证明仍有效。
  2. 选择正确入口。 目标项目已有“动态信息图”或同类工作台时,优先让它在配音完成后自动生成时间表。只有用户已提供最终音频、需要独立产物时才走手动对齐。
  3. 验证实现,不猜命令。 手动执行前,确认目标项目实际存在音频对齐器、短语构建器、Node、FFmpeg/FFprobe 与项目 Python 环境。常见实现会有 align.mjs 与 semantic_timeline.py;不要假定某个旧的 CLI 文件仍存在。
  4. 先对齐音频,再构建短语。 音频对齐器先写词级时间戳;短语构建器再使用原文和这些时间戳生成结果。不要按字符数量、页面时长或预设语速补全缺失时间。
  5. 严格验收。 覆盖率过低、短语顺序不能匹配、输出缺少真实时间边界,或结果来自估算回退时,应明确失败并保留诊断信息,而不是交付不可靠的时间表。

What it can do on your machine

Read from SKILL.md and the folder at commit 6f5009d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cs Narration Phrase Timeline loads about 500 tokens when it runs, and up to ~919 if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 79 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~500
With references · SKILL.md plus every file in references/, read only if the agent opens them
~919

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ChenShuo2004/cs-skills at commit 6f5009d, republished under its MIT licence (© ChenShuo2004). 79 words, ~500 tokens.

Download SKILL.mdSave it as .claude/skills/cs-narration-phrase-timeline/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
cs-narration-phrase-timeline
description
Use when the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or narration-driven infographic and motion-graphics timing. Requires the final narration audio and the exact spoken copy; do not use for estimated timing, generic editing, or MP4 rendering.
<!-- CS Skills · 陈硕 | portable skill entry | https://github.com/ChenShuo2004/cs-skills -->

口播短语时间表

目标与边界

将真实口播音频与实际朗读的中文稿对齐,交付按短语排序的 phrase-timeline.json。它为字幕、重点词、动态图文和 Motion Graphics 提供真实的毫秒与帧号边界。

这个 Skill 不生成配音、不按字数估算时间、不编辑时间线,也不导出 MP4。没有最终旁白音频时,不能把计划时长伪装成对齐结果。

输入与交付

需要:

  • 最终旁白音频;若是音色克隆工作流,使用克隆完成后的音频,不使用参考音频。
  • 与音频实际朗读内容一致的完整口播稿;不能用分镜提纲、摘要或事后改写稿替代。
  • 可选:现有任务目录、目标帧率(默认 30 fps)和输出位置。

交付:

  • alignment.tokens.json:真实语音识别的词级边界。
  • phrase-timeline.json:短语到真实毫秒/帧的映射。
  • 对齐结果摘要:音频总时长、全文覆盖率、失败原因或可用文件位置。

字段与验收要求见 时间表结构。

工作流

  1. 先找已有产物。 如果项目任务目录已经有 phrase-timeline.json,先检查它是否来自最终音频且符合结构;核对音频与稿件的哈希或等效来源记录以及目标帧率;一致且有效时直接复用,避免重新识别。仅文件名相同不足以证明仍有效。
  2. 选择正确入口。 目标项目已有“动态信息图”或同类工作台时,优先让它在配音完成后自动生成时间表。只有用户已提供最终音频、需要独立产物时才走手动对齐。
  3. 验证实现,不猜命令。 手动执行前,确认目标项目实际存在音频对齐器、短语构建器、Node、FFmpeg/FFprobe 与项目 Python 环境。常见实现会有 align.mjs 与 semantic_timeline.py;不要假定某个旧的 CLI 文件仍存在。 选择 WhisperX / faster-whisper 后,先核对所需 ASR 与中文对齐模型的版本、缓存路径、完整文件与哈希,复用有效缓存;只下载缺失文件,不为每个 Skill 新建模型副本。让实际加载器使用同一缓存或检查结果的本地模型目录。其他对齐后端沿用其配置,不强制下载 Whisper 模型;VAD 与 Python/GPU 依赖另行检查。
  4. 先对齐音频,再构建短语。 音频对齐器先写词级时间戳;短语构建器再使用原文和这些时间戳生成结果。不要按字符数量、页面时长或预设语速补全缺失时间。
  5. 严格验收。 覆盖率过低、短语顺序不能匹配、输出缺少真实时间边界,或结果来自估算回退时,应明确失败并保留诊断信息,而不是交付不可靠的时间表。

结果使用

  • 字幕与重点词:直接读取每个短语的起止毫秒或帧号。
  • 信息图与 Motion Graphics:元素不得早于对应口播短语开始出现。
  • 需要重新配音或改稿时:重新生成时间表;旧表不能复用于音频节奏已变化的版本。

完成检查

交付前确认:

  • timing_source 是基于真实音频的对齐来源,且 estimated_fallback_used 为 false。
  • phrases 按口播顺序排列,每条都有合法的起止时间与帧号。
  • 全文覆盖率、单短语覆盖率和置信度已保留;低覆盖率不会被静默忽略。
  • 口播稿、音频和生成文件中可能含有私密语音或文案;默认留在用户指定的本地任务目录,不上传或公开。

© ChenShuo2004, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in cs-narration-phrase-timeline of ChenShuo2004/cs-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/schema.md

Open the folder on GitHubat commit 6f5009d

Compare with similar skills

Cs Narration Phrase Timeline next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cs Narration Phrase Timeline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cs Narration Phrase Timeline this skillChenShuo2004/cs-skills197—~500Automated safety check: PassMIT
Media Useedenfunf/reelmimic1.9k1 repos~2kAutomated safety check: PassMIT
Hyperframesboraoztunc/skills3989 repos~7.6kAutomated safety check: PassApache-2.0
Hyperframes Creativechmonitor/chmonitor3015 repos~1.3kAutomated safety check: PassGPL-3.0
Bragvvedantb/eva1012 repos~2.3kAutomated safety check: PassMIT
Hbg Life SimulationMr-funny/hbg-life-simulation141—~5.8kAutomated safety check: PassMIT

Similar skills

  • Media Use

    edenfunf/reelmimic

    Agent Media OS, the single skill for every media need in a HyperFrames project.

    1.9k GitHub starsUsed in 1 repo~2k tokens
    Media & CreativeAuto-check passed
  • Hyperframes

    boraoztunc/skills

    Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML.

    398 GitHub starsUsed in 9 repos~7.6k tokens
    Media & CreativeAuto-check passed
  • Hyperframes Creative

    chmonitor/chmonitor

    Non-animation creative direction for HyperFrames videos. An agent skill from chmonitor/chmonitor.

    301 GitHub starsUsed in 5 repos~1.3k tokens
    Media & CreativeAuto-check passed
  • Brag

    vvedantb/eva

    Turn the current project website into a short, polished, shareable launch video using Hyperframes.

    101 GitHub starsUsed in 2 repos~2.3k tokens
    Media & CreativeAuto-check passed
  • Hbg Life Simulation

    Mr-funny/hbg-life-simulation

    Create Chinese HBG “模拟人生 / 人生副本” narrative videos with a consistent comic IP, a rapid multi-life opening, continuous natural-speed narration, synchronized short captions, dense static manga…

    141 GitHub stars~5.8k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Collage Broll Explainers

    MegaTroll222/VOX-COLLAGE-BROLL

    Turn a ~5-second voiceover line, opinion sentence, or abstract concept into a premium editorial halftone paper-collage B-roll clip — optionally with a fitted voiceover.

    216 GitHub stars~5.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from ChenShuo2004/cs-skills

All 26 skills in this repo
  • Cs Checkpoint Version

    ChenShuo2004/cs-skills

    A skill your agent uses when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky…

    197 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Cs Code Video

    ChenShuo2004/cs-skills

    用代码做动画视频:页面暴露 render(t),Playwright 逐帧截图 + FFmpeg 合成 mp4,可接合成配乐、出图和配音。通用模式先明确主题、规格、风格和声音,出风格卡、分镜与关键帧后逐镜制作;Vibe知识大赏模式额外查证来源、记录真实素材许可、先渲 10 秒样片。触发词包括…

    197 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Cs Knowledge Film

    ChenShuo2004/cs-skills

    制作明确要求暗夜星空、衬线双语字幕与金色光点风格的知识解说片,或用户显式调用 $cs-knowledge-film:从概念与画面隐喻设计,到口播、场景 spec、配音和 1080p 渲染。普通科普视频不默认套用这一视觉模板;网页产品演示、ChatCut 策划和电商视频复刻各用对应 skill。

    197 GitHub stars~806 tokensUpdated 3 days ago
    Auto-check passed
  • Cs Auto Videl

    ChenShuo2004/cs-skills

    A skill your agent uses when the user types $cs-auto-videl or asks for Douyin/TikTok ecommerce video workflows, including competitor replication, strong-Hook nine-grid promptimage.md to image2…

    197 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • 当用户要把产品事实、口播、数字人、产品界面和 CTA 制作成可验收的数字人产品介绍视频时使用:统一预检 ChatCut、FFmpeg、ComfyUI、Fish/TTS 与 Remotion,按 plan、sample、batch 三种模式编排,先完成可审批样片再批量或出成片。用于有明确产品包的横版/竖版产品视频流水线;不要用于通用自动剪辑、电商短视频复刻、纯视频选题策划或未经确认的批量生成与发布。

    197 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Cs Code Story Video

    ChenShuo2004/cs-skills

    把中文口播、角色和参考素材制作成可验收的 16:9 代码叙事视频:A-roll 角色讲述、全屏场景 B-roll、真实音频时码、Remotion 样片与成片、3:4/4:3 杂志风封面。仅用于代码驱动的叙事视频,不替代 ChatCut 剪辑、数字人产品片或电商复刻。

    197 GitHub stars~541 tokensUpdated 3 days ago
    Auto-check passed

Questions about Cs Narration Phrase Timeline

What does Cs Narration Phrase Timeline do?

A skill your agent uses when the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or…. Cs Narration Phrase Timeline is an agent skill from ChenShuo2004/cs-skills.json, 逐句或逐短语时间标注, Whisper word-boundary alignment, timed captions, or narration-driven infographic and motion-graphics timing.

When should I use Cs Narration Phrase Timeline?

Cs Narration Phrase Timeline fits situations like: the user needs a Chinese narration phrase timeline from real audio: phrase-timeline.json; whisper word-boundary alignment; narration-driven infographic and motion-graphics timing; estimated timing.

How do I install Cs Narration Phrase Timeline in Claude Code?

Run `npx skills add ChenShuo2004/cs-skills --skill cs-narration-phrase-timeline -a claude-code`. Or copy the skill folder (cs-narration-phrase-timeline in ChenShuo2004/cs-skills) into .claude/skills/cs-narration-phrase-timeline in your project. Claude Code loads it when a task matches its description.

How do I install Cs Narration Phrase Timeline in Codex?

Run `npx skills add ChenShuo2004/cs-skills --skill cs-narration-phrase-timeline -a codex`. Or copy the skill folder (cs-narration-phrase-timeline in ChenShuo2004/cs-skills) into .agents/skills/cs-narration-phrase-timeline in your project. Codex loads it when a task matches its description.

Can I use Cs Narration Phrase Timeline in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ChenShuo2004/cs-skills --skill cs-narration-phrase-timeline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cs-narration-phrase-timeline, .gemini/skills/cs-narration-phrase-timeline, .github/skills/cs-narration-phrase-timeline and .opencode/skills/cs-narration-phrase-timeline in your project.

What does Cs Narration Phrase Timeline need to run?

SKILL.md names no scripts, command-line tools or credentials: Cs Narration Phrase Timeline is instructions for the agent only. Our summary lists: Python 3.

Does Cs Narration Phrase Timeline access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cs Narration Phrase Timeline safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cs Narration Phrase Timeline use?

Cs Narration Phrase Timeline is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cs Narration Phrase Timeline use?

About 500 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 419 tokens, read only when the agent opens those files.

What are the alternatives to Cs Narration Phrase Timeline?

Skills that share tags, products or a category with Cs Narration Phrase Timeline: Media Use (edenfunf/reelmimic, 1.9k stars), Hyperframes (boraoztunc/skills, 398 stars), Hyperframes Creative (chmonitor/chmonitor, 301 stars) and Brag (vvedantb/eva, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cs Narration Phrase Timeline?

ChenShuo2004 (a GitHub user) maintains it in ChenShuo2004/cs-skills, which has 197 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

Source: ChenShuo2004/cs-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.