Agent Skills
› ChatCut-Inc/agent-plugin
ChatCut-Inc/agent-plugin
GitHub用于将本地或网络媒体导入ChatCut项目库。支持通过Claude Code浏览器面板即时拖拽导入，提供自动转录和预览；若需云备份或无面板环境，则回退至上传助手流程，确保资产状态正确以便后续编辑与导出。
Install All Skills
npx skills add ChatCut-Inc/agent-plugin --all -g -y
Skills in Collection (49)
用于将本地或网络媒体导入ChatCut项目库。支持通过Claude Code浏览器面板即时拖拽导入，提供自动转录和预览；若需云备份或无面板环境，则回退至上传助手流程，确保资产状态正确以便后续编辑与导出。
需要将本地视频/音频文件导入ChatCut项目
用户请求从URL或附件导入媒体资源
处理本地文件到云存储的同步或转码需求
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
为Claude Code提供ChatCut视频编辑的基础上下文，涵盖项目模型、编辑器交互及MCP工具调用规范。作为专业剪辑助手，指导用户完成从需求对齐到本地视频处理、字幕生成及导出的全流程操作。
用户在Claude Code中进行视频编辑或创作任务
涉及ChatCut项目的打开、导入、导出或媒体素材处理
需要调用ChatCut插件的MCP工具进行非线编操作
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics-claude -g -y
为Codex提供ChatCut视频编辑的基础上下文，涵盖项目模型、MCP路由及专业剪辑助手角色。用于处理视频剪辑、字幕、导出等任务，指导Agent在ChatCut环境中进行高效协作与操作。
用户请求视频剪辑或创作
涉及ChatCut项目的打开、编辑或导出
需要处理字幕、转录或素材管理
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
指导Codex通过内联JSX直接创建、编辑和放置ChatCut项目中的动态图形资产。涵盖项目状态检查、视觉对齐、代码编写及时间线集成，禁止使用生成式代理路径。
需要创建新的动态图形JSX资产
需要修改现有的动态图形JSX资产
需要将动态图形放置或移动到时间线上
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导ChatCut视频导出流程，要求使用submit_export和track_export处理持久化任务。规定Claude Code环境下通过curl下载文件并以文本形式交付路径及预览链接，禁止使用共享链接或本地ffmpeg替代标准导出。
用户请求导出、渲染或分享ChatCut视频
需要获取最终交付文件或字幕文件
询问本地与云端渲染的选择
npx skills add ChatCut-Inc/agent-plugin --skill export -g -y
通过后端API生成AI图像。支持gpt-image-2（文字渲染优）和nano-banana（参考图保真度高）模型。提交任务后返回jobId，需配合track_progress工具追踪进度。
用户要求生成图片、海报或视觉素材
用户提供参考图要求编辑、融合或作为视觉引导
npx skills add ChatCut-Inc/agent-plugin --skill image-gen -g -y
处理ChatCut插件工具调用失败或异常返回。涵盖edit_item数据格式修正、时间线重叠重试、路径限制规避、媒体导入转换失败处理及动态图形规范，提供具体错误修复方案。
ChatCut插件工具调用失败
工具返回意外数据结构
视频编辑操作报错
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
用于通过submit_music工具生成ChatCut视频所需的原创背景音乐、片头或BGM。支持基于文本提示创建音频资产，需结合时间轴工具完成剪辑与同步，不支持编辑现有音频或保证精确节拍对齐。
用户需要为视频生成背景音乐
用户请求创建片头音乐或音乐床
用户要求生成BGM
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
WebGL视频特效、转场及调色生成助手。优先通过browse_library查找内置资产，匹配失败才调用generate.ts生成新Shader。特别规定builtin:zoom必须使用track-bound模式，否则无法渲染。
用户请求视频滤镜或特效
用户请求转场效果
用户请求蒙版或遮罩
用户请求推近镜头
用户请求LUT调色
npx skills add ChatCut-Inc/agent-plugin --skill shader-gen -g -y
处理音视频转录、字幕生成与样式调整。涵盖本地及S3资产导入后的转录进度追踪、文本搜索、字幕启用，以及针对卡住或失败状态的智能重试逻辑。
用户请求为视频添加字幕或转录
需要清理说话人语音或去除填充词
检查转录就绪状态
从Codex启用字幕
npx skills add ChatCut-Inc/agent-plugin --skill transcription -g -y
验证ChatCut插件编辑结果，通过read_project检查结构，render_cloud_screenshot或view_asset_frames获取视觉证据。根据文件路径选择本地ffmpeg或远程工具进行源帧检查，区分源理解与最终时间线证明。
用户要求确认ChatCut项目中的编辑更改是否生效
需要验证时间线修剪、图层、字幕等具体效果
npx skills add ChatCut-Inc/agent-plugin --skill verification -g -y
通过Seedance 2.0和Kling生成视频，支持文生视频、图生视频及基于参考的剪辑扩展。提交任务后返回jobId，需配合track_progress管理进度。默认使用Seedance，特定场景可选Kling，并严格遵循模型参考文档。
用户希望生成视频片段
需要将文本或图片转换为视频
需要基于首尾帧或参考素材生成/扩展视频
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
用于生成语音（TTS）和音效。支持文本转语音、视频配音同步、现有旁白对齐调整及自定义音效生成。指定使用Doubao或ElevenLabs提供商，强调在有视觉目标时需参考视频同步指南以确保音画匹配。
用户希望从文本生成语音或旁白
需要为现有视频添加、替换或对齐配音
在修改视频后保持现有旁白同步
需要试听或选择TTS声音
需要生成库中不存在的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导在ChatCut插件中通过表单收集用户结构化输入，支持单选、多选、文本及媒体卡片。区分Codex与Claude Code运行时：前者使用ask_followup_questions，后者禁用该API并改用visualize.show_widget工具渲染原生HTML表单，确保兼容性与正确交互。
需要向用户请求结构化数据时
涉及单选、多选或文本字段输入时
需展示视觉风格卡或语音试听卡时
npx skills add ChatCut-Inc/agent-plugin --skill widget-forms -g -y
指导在ChatCut项目中导入媒体资产，涵盖本地文件、URL及已上传资源的智能路由选择，优先使用Browser-pane进行快速导入，并提供状态验证与回退机制。
需要导入本地视频或音频文件到项目
处理公开媒体URL的下载与推送
检查并复用编辑器中已存在的资产
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导通过Codex ChatCut工具使用JSX直接创建、编辑和放置动态图形资产，涵盖内容规划、样式对齐、API调用规范及运行时注意事项。
用户请求创建或编辑动态图形
需要生成Motion Graphic JSX代码
询问如何正确使用create_motion_graphic_from_code工具
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
用于导出 ChatCut 项目最终交付物，支持视频、音频、字幕及 XML 格式。通过提交渲染任务、跟踪状态并获取下载链接完成交付，处理云渲染阻塞及本地文件保存逻辑。
用户请求渲染或下载最终独立交付文件
需要导出视频、音频、字幕或 NLE XML
npx skills add ChatCut-Inc/agent-plugin --skill export -g -y
通过后端 API 生成 AI 图像，支持 gpt-image-2 和 nano-banana 模型选择、参数配置及进度追踪。适用于需要创建或编辑图片的场景，提供异步任务提交与状态查询功能。
用户请求生成图片或海报
基于参考图像进行图像编辑或融合
npx skills add ChatCut-Inc/agent-plugin --skill image-gen -g -y
诊断 ChatCut 插件工具失败、拒绝的突变及渲染阻塞等问题。提供导入媒体、生成动画和验证导出的标准化处理流程，确保基于当前 MCP schema 正确重试或报错，避免无效操作。
插件工具执行失败
媒体导入或转换异常
内容生成被拒绝
导出渲染受阻
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
用于生成动态图形（MG）的 AI 技能，指导 Agent 收集上下文、对齐视觉风格并构建结构化提示词，调用 Gemini 生成 MG 资产或修改现有代码。
需要创建动态图形动画
修改现有 MG 代码
修复损坏的动画
将 MG 转换为透明视频
npx skills add ChatCut-Inc/agent-plugin --skill motion-graphic-gen -g -y
基于文本提示生成原创背景音乐资产的技能，适用于视频配乐、开场音乐等场景。支持风格与情绪控制，需配合时间轴工具完成剪辑同步。
需要为视频生成背景音乐
创建片头或转场音乐
生成无版权风险的BGM
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成和配置 WebGL 视频特效、转场、遮罩及调色滤镜的 AI Shader 生成技能。遵循目录优先原则，先尝试内置资产，再调用后端任务生成新着色器，并提供时间轴参数配置指导。
用户请求视频特效或滤镜
需要添加转场效果如溶解或推镜头
要求对视频进行蒙版处理或电影感调色
npx skills add ChatCut-Inc/agent-plugin --skill shader-gen -g -y
处理音视频转录、字幕生成及修复。涵盖资产状态检查、进度跟踪、文本查找、转录重试与源词修复，以及基于脚本的语义编辑和填充词清理。
需要生成视频或音频的字幕/转写文本
检查媒体资产的转录状态或进度
修复错误的转录文本或清除填充词
进行基于语音的语义编辑设置
npx skills add ChatCut-Inc/agent-plugin --skill transcription -g -y
用于验证插件编辑结果是否准确反映在项目结构和时间线输出中。通过结合结构数据与视觉证据（如检查渲染帧），确保修改生效，防止虚假成功报告。
需要确认插件编辑后的项目结构变更
需要验证时间线输出的视觉效果
npx skills add ChatCut-Inc/agent-plugin --skill verification -g -y
提供基于 Seedance、Kling 和 Gemini Omni 等模型的 AI 视频生成能力，支持文生视频、图生视频及视频编辑扩展，提交任务后返回 jobId。
用户希望生成新的视频片段
用户需要对已有生成的视频进行修改或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
提供文本转语音（TTS）及自定义音效生成能力，支持为视频添加配音、替换旁白或保持音画同步，适用于多语言解说与音效制作场景。
用户需要生成文本转语音内容
用户需要为视频添加、替换或重新对齐旁白/配音
用户需要生成不在库中的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
适配 ChatCut、Codex 和 Claude Code 插件的主机适配器，通过特定工具调用结构化表单以获取用户输入。
需要向用户收集结构化数据时
不同插件主机间统一表单交互逻辑时
npx skills add ChatCut-Inc/agent-plugin --skill widget-forms -g -y
指导 Agent 通过外部连接器将本地或下载的媒体文件导入 ChatCut 项目，包括检查重复、下载资源、创建会话及调用脚本上传，并处理进度等待与错误重试。
用户请求导入媒体文件到项目中
需要将本地视频或音频资产添加至 ChatCut 工作区
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导通过Codex ChatCut工具直接编写Motion Graphic JSX，涵盖创建、编辑及时间轴放置流程。强调使用特定API而非上传，确保文本与样式可编辑，并规范动画时序调用与资产复用策略。
需要创建或编辑动态图形组件
在视频时间轴中插入或更新视觉素材
询问如何正确使用create_motion_graphic_from_code API
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
处理ChatCut项目的导出任务，包括视频、音频、字幕及XML格式的渲染与交付。通过submit_export发起任务，track_export追踪状态，并在完成后提供下载链接或本地文件预览，确保最终交付物的完整性。
用户请求渲染项目
用户请求下载最终独立交付物
用户请求导出视频、音频或字幕
npx skills add ChatCut-Inc/agent-plugin --skill export -g -y
通过后端API提交AI图像生成任务，支持gpt-image-2和nano-banana模型选择，处理提示词、参考图及参数配置。
用户要求生成图片
用户请求创建视觉素材
npx skills add ChatCut-Inc/agent-plugin --skill image-gen -g -y
诊断 ChatCut 插件工具失败、突变拒绝及导入生成错误，提供结构化重试与状态同步策略。
插件工具执行报错
媒体导入或生成失败
内容突变被拒绝
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
通过 submit_music 根据文本提示生成原创背景音乐资产，适用于视频配乐、开场音乐等场景。
用户需要为视频生成背景音乐
用户请求创建开场音乐或 BGM
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成WebGL视频特效、转场、蒙版及调色的Shader工具。遵循先查内置库后生成的原则，提供浏览、编辑和提交Shader作业的完整工作流。
用户需要创建视频滤镜或特效
用户需要添加转场效果
用户需要进行调色或LUT处理
用户需要应用遮罩或推拉镜头效果
npx skills add ChatCut-Inc/agent-plugin --skill shader-gen -g -y
用于处理音视频转录、字幕生成及修复的技能，涵盖资产状态检查、进度监控、文本查找、错误重试及语义编辑引导。
需要视频或音频文件的转录文本
生成或翻译字幕
修复错误的转录内容
进行基于语音的剪辑
npx skills add ChatCut-Inc/agent-plugin --skill transcription -g -y
验证插件编辑结果是否准确反映在项目结构和时间线输出中，结合结构与视觉证据确保渲染正确，避免误报成功。
需要确认插件修改后的项目结构变化
需要验证时间线可视化输出的准确性
npx skills add ChatCut-Inc/agent-plugin --skill verification -g -y
用于调用Seedance、Kling等AI模型生成或编辑视频片段，支持文生视频、图生视频及基于参考的修改扩展，提交任务并返回JobId。
用户希望生成视频片段
需要对已有视频进行生成式修改或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
提供文本转语音(TTS)、配音生成、视频配音同步及自定义音效生成功能。支持多语言TTS提供商选择、音频参数调节及与时间轴的音画同步维护。
用户需要将文本转换为语音或旁白
用户需要为现有视频添加、替换或重新制作配音
用户需要在视觉内容调整后保持配音同步
用户需要试听或选择TTS声音
用户需要生成不在库中的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导 Agent 在 Codex 和 Claude Code 插件中适配 ChatCut 表单交互。分别通过 MCP 工具或 Elicitation 机制收集结构化用户输入，确保跨平台兼容性并避免错误调用渲染标签。
需要向用户收集结构化数据时
需要在 ChatCut 环境中渲染表单界面时
开发 ChatCut 相关插件时
npx skills add ChatCut-Inc/agent-plugin --skill widget-forms -g -y
提供ChatCut产品知识，解答界面、功能、积分、订阅及计费问题。指导Agent无法直接执行的GUI操作，或在任务失败时作为手动操作的回退指南。不用于查询实时项目状态。
询问产品功能或界面布局
咨询积分、定价或订阅计划
需要执行Agent无法直接完成的GUI操作
任务失败需引导用户手动完成
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
指导口播、访谈及播客等以语音为主的视频剪辑，涵盖语音清理、MG动画叠加、B-roll补充、配乐及字幕制作，提供节奏感知与合规性指引。
用户需要剪辑口播或访谈类视频
请求去除口癖或整理语音节奏
要求在视频中叠加MG动画或B-roll素材
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
ChatCut插件基础技能，为Claude Code提供项目上下文、MCP工具发现及认证流程。处理视频编辑相关操作前的初始化，解决工具缺失时的登录问题，确保与ChatCut MCP服务器的正确连接。
使用ChatCut MCP工具前
涉及视频编辑或创建时
ChatCut工具不可用时
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics-claude -g -y
用于多机位/多录音素材的自动同步与对齐。通过转录文本分析识别摄像机角度和录音设备，构建重叠矩阵并计算时间偏移，生成同步主轨道，支持 speaker-follow 剪辑，适用于视频后期制作中的多源素材整合。
用户导入多个来自同一场次的松散剪辑片段
请求进行多机位（multicam/multi-angle）同步
需要将所有或部分内容切换为跟随说话人的剪辑
提及需要将独立音频（如领夹麦、现场录音）与画面对齐
npx skills add ChatCut-Inc/agent-plugin --skill multicam-sync -g -y
ChatCut产品知识库，解答UI、功能、计费、订阅及插件安装问题，提供GUI操作指引。当Agent无法直接执行任务时作为回退方案，指导用户手动完成操作。
询问ChatCut产品功能或使用方法
查询积分、定价、支付或订阅详情
需要下载桌面版或安装Agent插件
任务失败需引导用户进行GUI手动操作
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
指导口播、访谈及播客等语音主导视频的剪辑工作流，涵盖A-roll剪辑、MG动画叠加、B-roll插入、背景音乐及字幕处理，提供节奏感知与合规性检查。
需要剪辑口播或访谈视频
为视频添加MG动画或B-roll
进行语音清理或去口癖
生成视频字幕或背景音乐
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
为 Codex 提供 ChatCut 视频编辑的基础上下文，涵盖项目模型、MCP 工具路由及认证故障排查。指导 AI 在视频剪辑、字幕处理等任务中作为专业助手协作，确保正确连接 ChatCut 服务。
使用 ChatCut 进行视频编辑或创建
ChatCut 工具不可用需排查登录问题
需要打开或导入 ChatCut 项目
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
用于多机位及独立音频录音的自动同步与对齐，基于转录文本生成同步主轨，支持 speaker-follow 剪辑。
需要多机位素材同步
请求 speaker-follow 或谁说话剪谁的编辑
npx skills add ChatCut-Inc/agent-plugin --skill multicam-sync -g -y
提供ChatCut产品知识库，解答UI、功能、计费、订阅及插件安装等问题。当任务失败时，作为回退方案指导用户进行手动GUI操作，涵盖桌面端下载与Agent插件配置。
询问ChatCut功能或使用方法
查询积分、支付、订阅或定价
需要下载桌面版或安装插件
自动化任务失败需引导手动操作
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
针对口播、访谈及播客等语音主导视频的剪辑指南，涵盖A-roll剪辑、MG动画叠加、B-roll插入、背景音乐、字幕及AI人声隔离，提供节奏与画面处理建议。
口播视频剪辑
访谈节目后期制作
视频播客编辑
去除口癖和停顿
添加MG动画或B-roll
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
