Agent skill

Video Script

by ZJU-REAL in ZJU-REAL/Easel

生成视频脚本,覆盖短视频(7-60秒)到中长视频(1-30分钟)全时长. An agent skill from ZJU-REAL/Easel.

Apache-2.0Auto-check passedMedia & Creative

Install Video Script

skills CLI
$ npx skills add ZJU-REAL/Easel --skill video-script -a claude-code

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

GitHub CLI
$ gh skill install ZJU-REAL/Easel video-script --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/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/video-script .claude/skills/video-script && 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
video-script
GitHub stars
3.3k
Token cost
~853 tokens
SKILL.md length
308 words
Files
3 (incl. references)
Skills in repo
113
Repo updated
First seen
Licence
Apache-2.0

At a glance

生成视频脚本,覆盖短视频(7-60秒)到中长视频(1-30分钟)全时长. An agent skill from ZJU-REAL/Easel.

  • Works in 9 steps: Hook 设计(3 个变体) → 分秒脚本 → caption + 封面 → …
  • Tasks that involve Video scripts and shorts
  • SKILL.md covers 输入, 模式自动判定, 短视频模式(≤60 秒) and 中长视频模式(>60 秒), plus 3 more sections
  • Calls python3

What it does

Video Script is an agent skill from ZJU-REAL/Easel. 生成视频脚本,覆盖短视频(7-60秒)到中长视频(1-30分钟)全时长。 短视频:Hook 变体评分、分秒计时、字幕文案、封面方案。 中长视频:留存率优化、节奏中断点、前向钩子、章节结构。 适用于抖音、视频号、小红书视频、B站、YouTube 等平台。 当用户说"视频脚本"、"短视频脚本"、"抖音脚本"、"B站脚本"、 "视频号脚本"、"竖版视频"、"Reel 脚本"、"写个视频文案"时使用。 和 video-strategy 的区别:video-strategy 做视频内容规划和系列策划, video-script 写具体某一条视频的脚本。

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `EASEL-META.md` and `references/retention-scripting-guide.md`).

It sits in Media & Creative, covering Video scripts and shorts. It works with YouTube. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Video scripts and shorts

Example prompts

  • “Reel 脚本”
  • “写个视频文案”
  • “/video-script”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Hook 设计(3 个变体)
  2. 分秒脚本
  3. caption + 封面
  4. 质量评分(满分 100)
  5. 结构计算
  6. 写 Hook(三段式)
  7. 内容段落
  8. CTA 与结尾
  9. 留存风险标注

What it can do on your machine

Read from SKILL.md and the folder at commit 5e0ccc1. 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

    Shell commands in SKILL.md call:

    • python3

    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

Video Script loads about 853 tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 308 words of instructions outside code blocks.

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

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 ZJU-REAL/Easel at commit 5e0ccc1, republished under its Apache-2.0 licence (© ZJU-REAL). 308 words, ~853 tokens.

Download SKILL.mdSave it as .claude/skills/video-script/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
video-script
description
生成视频脚本,覆盖短视频(7-60秒)到中长视频(1-30分钟)全时长。 短视频:Hook 变体评分、分秒计时、字幕文案、封面方案。 中长视频:留存率优化、节奏中断点、前向钩子、章节结构。 适用于抖音、视频号、小红书视频、B站、YouTube 等平台。 当用户说"视频脚本"、"短视频脚本"、"抖音脚本"、"B站脚本"、 "视频号脚本"、"竖版视频"、"Reel 脚本"、"写个视频文案"时使用。 和 video-strategy 的区别:video-strategy 做视频内容规划和系列策划, video-script 写具体某一条视频的脚本。
layer
produce

视频脚本生成

根据目标时长自动适配短视频或中长视频模式,生成留存率优化的结构化脚本。

输入

字段必填说明示例
主题是视频主题"为什么 Rust 正在替代 C++"
目标时长是秒数或分钟数30 秒 / 10 分钟
平台否抖音/视频号/小红书/B站(默认按时长推断)抖音
内容类型否科普/教程/评测/种草/解说/杂谈科普
核心要点是要覆盖的关键信息内存安全、性能…
调性否专业/轻松/犀利/对话感(默认:对话感)轻松

模式自动判定

时长模式典型平台关键指标
7-15 秒短视频·极速抖音/视频号3 秒完播率
15-60 秒短视频·标准抖音/视频号/小红书完播率、DM 转发、收藏
1-5 分钟中视频视频号/抖音/B站5 秒留存、互动率
5-30 分钟长视频B站/YouTube30 秒留存、播放完成率

语速基准:中文约 250 字/分钟。


短视频模式(≤60 秒)

Step 1 — Hook 设计(3 个变体)

从 5 种 Hook 类型中选 3 个,各生成一个变体:

类型适用场景示例
好奇缺口冷知识、反直觉"你每天做的这件事其实在伤害你"
模式打断反常规、挑战认知"忘掉你以前学的所有XX"
身份触发精准受众"如果你是XX,这条一定要看完"
痛点共鸣真实困扰"明明很努力了还是没效果?"
权威背书数据/研究支撑"最新研究发现:XX 竟然是错的"

每个 Hook 按 4 维度评分(每项 1-5,满分 20):好奇强度、打断效果、身份触发、3 秒清晰度。选最高分作为主 Hook。

Step 2 — 分秒脚本

按时长压缩结构:

时长结构
7-15 秒Hook(0-2s) + 核心价值(2-10s) + 收尾(10-15s)
15-30 秒Hook(0-3s) + 痛点(3-8s) + 方案(8-20s) + 收尾CTA(20-30s)
30-60 秒Hook(0-3s) + 痛点(3-8s) + 方案(8-40s) + 洞察+CTA(40-60s)

脚本格式:

[0-3s] HOOK
口播: "..."
字幕: "..."
画面: [描述]

[3-8s] 痛点
口播: "..."
画面: [描述]

每句 ≤15 字,口语化,加括号注释(停顿/强调/表情)。

Step 3 — caption + 封面

caption:100-300 字,Hook 变体开头(不重复视频 Hook),DM 转发 > 收藏 > 点赞。 hashtags:3-5 个垂直标签,不用泛标签。 封面:3-5 字大标题 + 画面描述 + 表情。

Step 4 — 质量评分(满分 100)
维度权重检查点
Hook 强度25好奇缺口、打断效果、3 秒清晰度
内容质量25价值密度、结构、痛点-方案清晰度
caption+CTA20长度 100+字、转发型 CTA、Hook 变体
格式合规159:16 安全区、时长匹配、封面
算法信号15收藏/转发优化、原创性

≥80 分交付,<60 分返工后重评。


中长视频模式(>60 秒)

留存率优化的详细方法(节奏中断点 / 前向钩子 / 章节结构 / 留存曲线)见 references/retention-scripting-guide.md。

Step 1 — 结构计算

根据目标时长分配各段:

  • Hook:0:00-0:30(短视频缩短到 0:00-0:10)
  • 开场:0:30-2:00
  • 首次 CTA:约 25% 处
  • 留存再拉回:约 60% 处
  • 结尾:最后 60 秒
  • 目标字数 = 时长(分钟) × 250
Step 2 — 写 Hook(三段式)
阶段时间目标
抓眼0-5s全片最重要的一句话,不加片头
承诺5-15s看完能获得什么,具体可感知
悬念15-30s不看会损失什么
Step 3 — 内容段落

每段结构:节奏中断 → 正文 → 微总结 → 前向钩子。 节奏中断每 60-90 秒一次(短视频每 15-30 秒),类型:【镜头切换】【画面】【音效】【数据冲击】。

Step 4 — CTA 与结尾
  • 首次 CTA(25% 处):软性、对话式、10-15 秒
  • 留存再拉回(60% 处):"接下来是最关键的部分"
  • 结尾 CTA:硬性号召 + 下期预告,不说"感谢观看"
Step 5 — 留存风险标注

扫描全稿,在危险区标 ⚠️ 警告(至少 3 处)+ 应对方案。

输出格式

产物写入 outputs/。包含:

  • 脚本元数据(主题/时长/平台/字数)
  • 完整分段脚本(含时间码、口播、字幕、画面提示)
  • 节奏中断日志(时间戳/类型/说明)
  • 留存风险地图(中长视频)/ 质量评分(短视频)
  • 剪辑备注

质量检查

  • 字数与时长匹配(250 字/分钟,±10%):用脚本判定,不靠估算。把全部口播文案(去掉时间码、画面提示等非口播行)喂给 python3 skills/shared/scripts/wordcount.py check --target <时长分钟×250> --tolerance 0.1(stdin 传入),退出码 0 = 达标;非 0 时脚本给出「还需增/删 X 字」,据结果增删口播后重跑,直到通过。
  • Hook 完整(短视频 3 变体评分;中长视频三段式)
  • 节奏中断频率达标
  • CTA 位置正确
  • 全稿口语化,短句,不像书面文
  • 结尾有能量,不含收尾废话

Profile 感知

  • 有 Profile:读取 platform 锁定平台、audience 调整用语、tone 匹配风格、cta_style 使用惯用话术
  • 无 Profile:默认按时长推断平台,对话感调性

© ZJU-REAL, Apache-2.0. 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 skills/openclaw/video-script of ZJU-REAL/Easel.

  • SKILL.md
  • EASEL-META.md
  • references/retention-scripting-guide.md

Open the folder on GitHubat commit 5e0ccc1

Compare with similar skills

Video Script 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.

Video Script compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video Script this skillZJU-REAL/Easel3.3k—~853Automated safety check: PassApache-2.0
Yt ScriptJakeschincariol/youtube-agent-skill795—~672Automated safety check: PassMIT
Youtube Viral Optimizerinfranodus/skills119—~3.6kAutomated safety check: PassNone
Short Publishgug007/lpm152—~3.1kAutomated safety check: PassMIT
Lesson Publishgug007/lpm152—~1.8kAutomated safety check: PassMIT
Analyze Socialccplugins/awesome-claude-code-plugins970—~1.1kAutomated safety check: WarnApache-2.0

Similar skills

  • Yt Script

    Jakeschincariol/youtube-agent-skill

    Write a YouTube video script from a raw idea - hook options off 21 formulas, scored, then the full spoken script with the retention beats marked.

    795 GitHub stars~672 tokensUpdated 22 days ago
    Media & CreativeAuto-check passed
  • Youtube Viral Optimizer

    infranodus/skills

    Generate high-CTR YouTube thumbnails, titles, and video scripts optimized for virality.

    119 GitHub stars~3.6k tokensUpdated 18 days ago
    Media & CreativeAuto-check passed
  • Short Publish

    gug007/lpm

    Post a finished vertical lesson from ~/Movies/lpm-lessons/tiktok/<slug/ to YouTube Shorts (LPM channel, through Chrome) and TikTok (@lpm06557, from the user's iPhone through iPhone Mirroring) in…

    152 GitHub stars~3.1k tokensUpdated today
    Media & CreativeAuto-check passed
  • Lesson Publish

    gug007/lpm

    Publish a finished lesson MP4 from ~/Movies/lpm-lessons/<slug/ to the lpm YouTube channel through Chrome (YouTube Studio): search-optimized title and description with chapters, tags, category, the…

    152 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed
  • Analyze Social

    ccplugins/awesome-claude-code-plugins

    A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…

    970 GitHub stars~1.1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: warnings
  • Memstack Content Youtube Script

    cwinvestments/memstack

    A skill your agent uses when the user says 'YouTube script', 'video script', 'write script for YouTube', 'YouTube video outline', or is creating scripted content for a YouTube video with hooks…

    423 GitHub stars~3.5k tokensUpdated 12 days ago
    Media & CreativeAuto-check passed

More from ZJU-REAL/Easel

All 113 skills in this repo
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.3k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.3k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.3k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.3k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Paper Explainer

    ZJU-REAL/Easel

    科研论文解读:解析 arXiv/PDF 的公式与图表,提炼问题、贡献、方法、关键图和结论,再产出 B站/视频号解读视频或知乎/公众号图文。

    3.3k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Video Script

What does Video Script do?

生成视频脚本,覆盖短视频(7-60秒)到中长视频(1-30分钟)全时长. An agent skill from ZJU-REAL/Easel. Video Script is an agent skill from ZJU-REAL/Easel.

When should I use Video Script?

Video Script fits situations like: tasks that involve Video scripts and shorts.

How do I install Video Script in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill video-script -a claude-code`. Or copy the skill folder (skills/openclaw/video-script in ZJU-REAL/Easel) into .claude/skills/video-script in your project. Claude Code loads it when a task matches its description.

How do I install Video Script in Codex?

Run `npx skills add ZJU-REAL/Easel --skill video-script -a codex`. Or copy the skill folder (skills/openclaw/video-script in ZJU-REAL/Easel) into .agents/skills/video-script in your project. Codex loads it when a task matches its description.

Can I use Video Script 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 ZJU-REAL/Easel --skill video-script -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-script, .gemini/skills/video-script, .github/skills/video-script and .opencode/skills/video-script in your project.

What does Video Script need to run?

Going by SKILL.md and its folder, Video Script needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Video Script 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 Video Script 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 Video Script use?

Video Script is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Video Script use?

About 853 tokens (SKILL.md is roughly 3.4k 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 2k tokens, read only when the agent opens those files.

What are the alternatives to Video Script?

Skills that share tags, products or a category with Video Script: Yt Script (Jakeschincariol/youtube-agent-skill, 795 stars), Youtube Viral Optimizer (infranodus/skills, 119 stars), Short Publish (gug007/lpm, 152 stars) and Lesson Publish (gug007/lpm, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video Script?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,310 GitHub stars. The repository holds 113 skills in this directory. The repository was last updated on October 9, 2026.

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