HyperFrames Animation
heygen-com/hyperframes
Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.
智能转换视频画幅，支持 9:16/16:9/1:1、模糊背景填充、焦点裁切和人脸居中裁切。当用户说“横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”时使用。通用简单裁切用 video-editing；逐段动态人脸跟随切片用 clipify。
Install Video Reframe
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ZJU-REAL/Easel video-reframe --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/video-reframe .claude/skills/video-reframe && rm -rf skills-srcUse ~/.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/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .claude/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ZJU-REAL/Easel video-reframe --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/openclaw/video-reframe .agents/skills/video-reframe && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .agents/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ZJU-REAL/Easel video-reframe --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/openclaw/video-reframe .cursor/skills/video-reframe && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .cursor/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ZJU-REAL/Easel.git --path skills/openclaw/video-reframe--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ZJU-REAL/Easel video-reframe --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/openclaw/video-reframe .gemini/skills/video-reframe && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .gemini/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ZJU-REAL/Easel video-reframeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/openclaw/video-reframe .github/skills/video-reframe && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .github/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ZJU-REAL/Easel --skill video-reframe -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ZJU-REAL/Easel video-reframe --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/openclaw/video-reframe .opencode/skills/video-reframe && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "video-reframe" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/video-reframe into .opencode/skills/video-reframe/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-reframe", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
video-reframe- GitHub stars
- 3.4k
- Token cost
- ~492 tokens
- SKILL.md length
- 112 words
- Files
- 1
- Skills in repo
- 114
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
智能转换视频画幅，支持 9:16/16:9/1:1、模糊背景填充、焦点裁切和人脸居中裁切。当用户说“横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”时使用。通用简单裁切用 video-editing；逐段动态人脸跟随切片用 clipify。
- Works in 5 steps: 拿不准选哪种：横转竖优先 blur（不丢画面）；主体明确且想铺满用… → smart 未检出人脸时自动退化为居中裁切，并在报告里说明。 → 音轨自动保留（copy），不重编码音频。 → …
- Tasks that involve Video production
- SKILL.md covers 输入, 输出（outputs/主题名/）, 执行步骤 and Profile 感知, plus 2 more sections
- Calls python
What it does
Video Reframe is an agent skill from ZJU-REAL/Easel. 智能转换视频画幅，支持 9:16/16:9/1:1、模糊背景填充、焦点裁切和人脸居中裁切。当用户说“横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”时使用。通用简单裁切用 video-editing；逐段动态人脸跟随切片用 clipify。
Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Media & Creative, covering Video production. 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 production
Example prompts
- “横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”
- “/video-reframe”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- 拿不准选哪种：横转竖优先 blur（不丢画面）；主体明确且想铺满用 crop；人物口播用 smart。
- smart 未检出人脸时自动退化为居中裁切，并在报告里说明。
- 音轨自动保留（copy），不重编码音频。
- 输出分辨率强制偶数对齐（H.264 要求），无需手动处理。
- 产物统一进 outputs/主题名/。
What it can do on your machine
Read from SKILL.md and the folder at commit 278f420. 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:
python
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 Reframe loads about 492 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 112 words of instructions outside code blocks.
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 278f420, republished under its Apache-2.0 licence (© ZJU-REAL). 112 words, ~492 tokens.
Download SKILL.mdSave it as
.claude/skills/video-reframe/SKILL.md (or your agent's skills folder).- name
- video-reframe
- description
- 智能转换视频画幅，支持 9:16/16:9/1:1、模糊背景填充、焦点裁切和人脸居中裁切。当用户说“横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”时使用。通用简单裁切用 video-editing；逐段动态人脸跟随切片用 clipify。
- layer
- produce
视频画幅智能转换（竖横互转）
把视频转到目标宽高比，三种策略可选。全部走
skills/shared/scripts/reframe.py， 不要手拼 crop/overlay 滤镜——脚本已算好裁切尺寸、焦点边界、偶数对齐、音轨保留。
| 模式 | 效果 | 适用 |
|---|---|---|
blur（默认） | 原画完整居中 + 放大模糊的自身作背景，无黑边 | 横转竖最常用，画面不丢内容 |
crop | 按焦点位置裁到目标比例，无黑边但裁边缘 | 主体明确、想铺满屏幕 |
smart | cv2 检测人脸 → 以人脸中位位置为焦点裁切 | 口播/人物视频横转竖 |
需要逐镜头动态追踪人脸做 pan 见 clipify；只想加黑边/居中裁见 video-editing
aspect。
输入
| 字段 | 必填 | 说明 |
|---|---|---|
| 视频文件 | 是 | 要转换的视频（没给就问） |
| 目标比例 | 是 | 9:16 / 16:9 / 1:1 / 4:5 / 3:4 / 4:3 / 21:9 |
| 模式 | 否 | blur（默认）/ crop / smart |
| 焦点 | 否 | crop 模式下主体不在中间时用 --focus-x（0 左 1 右） |
输出（outputs/主题名/）
- 转换后视频（
*-<比例>.mp4） - 报告：源→目标尺寸、比例、所用策略、人脸焦点（smart 时）
执行步骤
脚本路径（相对项目根）：skills/shared/scripts/reframe.py（reframe -h 看参数）。
# 横版转竖版，模糊背景填充（最稳，画面不丢）
python skills/shared/scripts/reframe.py reframe -i <视频> \
-o outputs/主题名/<名>-9x16.mp4 --ratio 9:16 --mode blur
# 焦点裁切，主体偏右时把焦点拉到 0.65
python skills/shared/scripts/reframe.py reframe -i <视频> \
-o outputs/主题名/<名>-9x16.mp4 --ratio 9:16 --mode crop --focus-x 0.65
# 人脸感知裁切（口播/人物视频）
python skills/shared/scripts/reframe.py reframe -i <视频> \
-o outputs/主题名/<名>-9x16.mp4 --ratio 9:16 --mode smart--size WxH 可强制最终分辨率（默认按比例与源分辨率推算，如 1280x720 → 720x1280）。
Profile 感知
- 有 Profile：默认目标比例按
platforms.md主平台（抖音/小红书竖版 9:16，B站横版 16:9， 朋友圈/ins 方形 1:1）；口播/人物类账号默认smart模式。 - 无 Profile：默认
blur模式 + 询问目标平台/比例。
规则
- 拿不准选哪种：横转竖优先
blur（不丢画面）；主体明确且想铺满用crop；人物口播用smart。 smart未检出人脸时自动退化为居中裁切，并在报告里说明。- 音轨自动保留（copy），不重编码音频。
- 输出分辨率强制偶数对齐（H.264 要求），无需手动处理。
- 产物统一进
outputs/主题名/。
参考来源
模糊背景填充（blurred bars）是竖屏适配的主流做法；人脸感知裁切参考 AI-Youtube-Shorts-Generator 思路，用 OpenCV Haar 级联检测人脸中位位置定焦点。把裁切几何与边界钳制封装成确定性脚本。
© 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
Just SKILL.md in skills/openclaw/video-reframe of ZJU-REAL/Easel.
Open the folder on GitHubat commit 278f420
Compare with similar skills
Video Reframe 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Video Reframe this skillZJU-REAL/Easel | 3.4k | — | ~492 | Automated safety check: Pass | Apache-2.0 | |
| HyperFrames Animationheygen-com/hyperframes | 60k | 3 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills | 8.5k | 6 repos | ~3.2k | Automated safety check: Notes | Apache-2.0 | |
| Faceless Explainer Videoheygen-com/hyperframes | 60k | 3 repos | ~7.7k | Automated safety check: Notes | Apache-2.0 | |
| Video Understandcalesthio/OpenMontage | 66k | — | ~841 | Automated safety check: Pass | AGPL-3.0 | |
| Video ShotcraftVincentwei1021/video-shotcraft | 11k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Stitch to Remotion Walkthrough Videos
google-labs-code/stitch-skills
Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.
Faceless Explainer Video
heygen-com/hyperframes
Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.
Video Understand
calesthio/OpenMontage
Understand video content locally using ffmpeg frame extraction and Whisper transcription.
Video Shotcraft
Vincentwei1021/video-shotcraft
Makes cinematic product videos with Remotion from shot recipe cards, a ready template, real page screenshots, camera moves and sound design, or builds a single animated shot.
Figma to HyperFrames
heygen-com/hyperframes
Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.
More from ZJU-REAL/Easel
All 114 skills in this repoGzh Design
ZJU-REAL/Easel
微信公众号文章排版引擎：把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML，自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名；主题从 references/theme-index.md…
Skill Wechat Publisher
ZJU-REAL/Easel
微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息、生成图文并茂的公众号文章，并发布到微信公众号草稿箱。特别强调反 AI 检测写作。
Card Design
ZJU-REAL/Easel
社媒卡片视觉设计系统：提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检，避免模板化 PPT 与廉价 AI 感。
Ecom Details Image
ZJU-REAL/Easel
生成电商商品视觉方案：主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.
Infographic
ZJU-REAL/Easel
将数据或文字内容转化为可视化信息图，支持静态（AntV）和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画；要单张静态图片 URL 用 chart-visualization，要 CSV/JSON→整页报告用 data-report
Novel Writer
ZJU-REAL/Easel
长篇小说/网文连载创作：从世界观、人设和三级大纲写到逐章正文，并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.
Related
Categories
Questions about Video Reframe
What does Video Reframe do?
智能转换视频画幅，支持 9:16/16:9/1:1、模糊背景填充、焦点裁切和人脸居中裁切。当用户说“横竖版互转、改成 9:16、转竖屏、去黑边、适配平台尺寸、人脸居中裁”时使用。通用简单裁切用 video-editing；逐段动态人脸跟随切片用 clipify。. Video Reframe is an agent skill from ZJU-REAL/Easel.
When should I use Video Reframe?
Video Reframe fits situations like: tasks that involve Video production.
How do I install Video Reframe in Claude Code?
Run `npx skills add ZJU-REAL/Easel --skill video-reframe -a claude-code`. Or copy the skill folder (skills/openclaw/video-reframe in ZJU-REAL/Easel) into .claude/skills/video-reframe in your project. Claude Code loads it when a task matches its description.
How do I install Video Reframe in Codex?
Run `npx skills add ZJU-REAL/Easel --skill video-reframe -a codex`. Or copy the skill folder (skills/openclaw/video-reframe in ZJU-REAL/Easel) into .agents/skills/video-reframe in your project. Codex loads it when a task matches its description.
Can I use Video Reframe 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-reframe -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-reframe, .gemini/skills/video-reframe, .github/skills/video-reframe and .opencode/skills/video-reframe in your project.
What does Video Reframe need to run?
Going by SKILL.md and its folder, Video Reframe needs the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Video Reframe 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 Reframe 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 Reframe use?
Video Reframe 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 Reframe use?
About 492 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.
What are the alternatives to Video Reframe?
Skills that share tags, products or a category with Video Reframe: HyperFrames Animation (heygen-com/hyperframes, 60k stars), Stitch to Remotion Walkthrough Videos (google-labs-code/stitch-skills, 8.5k stars), Faceless Explainer Video (heygen-com/hyperframes, 60k stars) and Video Understand (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Video Reframe?
ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,376 GitHub stars. The repository holds 114 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.