Communitygithub.com

2789927464king-jpg/video-skill-ku

Operate existing projects in the chengfeng-videocut editing workspace via Runtime CLI: query projects and word positions, add or replace overlay clips, remove pictures, delete specific words or segments, split/crop/move existing clips, adjust canvas aspect ratio, and read back to verify.

What is video-skill-ku?

This skill is designed for AI agents interacting with the chengfeng-videocut video editing platform. It provides a structured way to perform precise edits on existing projects through a Runtime CLI, without acting as a separate editing engine. The agent can query project details, locate words or clips, overlay media while preserving original audio, delete specific elements, split and reorder clips, and adjust canvas settings. The workflow enforces a strict read-plan-submit-verify-deliver cycle, ensuring that every write operation is confirmed by a read-back before proceeding. It explicitly avoids automatic error correction, creative animation, subtitle tasks, exports, or troubleshooting. Supported platforms include any environment that exposes the chengfeng-videocut Runtime CLI and its associated workbench commands.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-videocut-workbench

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Workbench Operations

Convert explicit editing requests into existing CLI operations, always reading back results within the same project. This is not a separate editing engine, nor is it a mandatory entry point before using other skills.

First, Identify the Action

What the user wantsThis skill's approach
View the current project, find a phrase, see existing clips and picturesRead-only positioning; see Operations
Add an animation or video over a phrase while preserving the original voice-overOverlay clip; timeline does not extend; see Operations
Delete a picture, word, or clipDistinguish between object and audio impact; see Deletion Methods
Split into two segments, shorten a segment, reorder existing clipsEDL modification; see Operations
Change aspect ratio (landscape/portrait), fill or fit the frameDistinguish between project canvas and media fit; see Operations
Insert new material at any position on the main timeline and shift everything afterFirst check current capabilities; if no generic insert command exists, clearly state the limitation—do not misrepresent overlay or move operations as inserts

When the user says "insert", first determine whether it means overlaying a picture while the voice-over continues, or adding new duration and shifting everything after. When the user says "delete", first determine whether it means removing a picture or cutting out the audio and time. If the intent is clear, execute without repeated questioning. For duplicate phrases, reused material, or non-unique targets, list all positions for confirmation; do not guess based on text alone.

Automatic detection of speech errors, duplicates, or which version to keep should be handed to the Voice-Over Trimming Skill. Subtitle content and layout go to the Subtitle Skill. Shot/creative animation goes to the appropriate Design Skill. Final output goes to the Export Skill. Connection issues and upgrades go to Maintenance & Troubleshooting. Do not automatically launch additional agents or install missing skills.

Standard Operation Flow

  1. Connect: On first connection or when credentials change, read Connection and Submission in full. Retain the confirmed Runtime parameter array, explicit origin, server projectId, and capabilities—do not rediscover the environment for every action.
  2. Read: Read only the relevant documents; save the document's own revision, target ID, original values, and expected results. If locating words, paginate and read fully when necessary. Confirm source identity and instance; do not confuse subtitle cue IDs with word IDs.
  3. Plan: Briefly describe which object will be changed, whether the timeline will be shortened, and whether audio will be affected. Do not repeatedly confirm scope that the user has already authorized. New impacts (e.g., additional removal of dependent layers) must be explicitly authorized first.
  4. Submit: Follow the actual fields and patterns of workbench commands --json. Use --confirmed on write operations to indicate that authorization is already granted—this is not a switch that grants permission to the agent. Edit the production project only through the Runtime; do not modify the project JSON directly.
  5. Verify: Read back the affected resources; check IDs, differences, and duration. If necessary, verify word anchors, subtitle status, and picture timing. When performing multiple patches in sequence, only construct the next step after the previous one has been successfully read back. This is not an atomic batch transaction.
  6. Deliver: Report separately what data was written, whether the picture/audio was actually verified, and any unsupported or unvalidated items. A successful submission does not mean the preview or final output passed. A page not refreshed does not mean nothing was written. Always read back first; do not submit again just to "refresh".

On Failure, Stop Writing

  • Conflict: Re-read the current differences. Old approvals are not automatically replayed by replacing with the new revision. Only after confirming the new target and impact, make a new plan.
  • Timeout, disconnection, or readback failure: The result may still have been written. Save the original request and identity. Query precisely by the corresponding resource, asset hash, or original operationId. If not found, it doesn't prove the submission did not happen. Do not blindly retry with a different ID.
  • Insufficient resources, ambiguous target, missing capability: Report the specific blocker; preserve the existing project. Do not automatically upgrade, restart, re-transcribe, modify registry, or switch to another tool.
  • Do not provide fictional commands for generic undo/redo, volume mixing, playback control, or arbitrary timeline insertion of new media. playback is for reading the playback word stream; operation-recover is for limited transaction recovery, not arbitrary undo.
  • Deletion only affects the specified object within the project; do not clean up original videos, recordings, imported assets, module files, or caches.

Typical Requests

  • "Overlay this MP4 on the second sentence; keep the audio as is." → Locate the real word ID, import the media, add a new overlay while keeping the old one, read back.
  • "Remove the small black animation I just added." → Locate the unique layer, remove only that layer; do not trim the voice-over, do not delete the animation source file.
  • "Delete the third occurrence of this sentence and join the rest." → Verify the third instance, follow the supported word/clip deletion flow, and verify the new duration.
  • "Split the first segment in half, then move the second half to the end." → Use clip partial cut followed by second-based splitting, read back the new IDs, then move according to magnetic timeline rules.

Individual skills in this repo

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

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Related Skills