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等路由，处理本地文件、已上传资产及转录准备。
需要导入视频或音频到项目
处理本地文件或聊天附件
检查资产是否已存在
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导ACP/CLI代理在ChatCut Desktop中通过内联JSX创建、编辑和放置动态图形资产，涵盖视觉对齐、时间轴定位及本地验证。
需要创建新的动态图形JSX资产
需要修改现有动态图形属性
需要将动态图形放置到视频时间轴
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导导出 ChatCut 项目为最终交付物，涵盖视频、音频及字幕等格式。通过 submit_export 发起渲染，track_export 监控状态，并处理本地下载或云渲染异常，确保生成可下载的独立文件。
用户请求渲染视频或音频
用户请求下载最终交付物
用户请求导出字幕或 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
AI动态图形生成技能，指导Agent构建高质量Gemini提示词以生成MG动画。涵盖上下文收集、风格对齐、8字段Brief编写及任务进度追踪，支持多种场景下的MG创建与优化。
需要生成动态图形或MG动画
将文本内容转换为透明背景视频资产
修改或修复现有MG代码
为Gemini AI准备动态图形生成的详细提示词
npx skills add ChatCut-Inc/agent-plugin --skill motion-graphic-gen -g -y
通过submit_music工具，根据文本提示生成原创背景音乐音频资产。适用于需要视频配乐、片头曲或背景音的场景，不支持编辑现有音频。
用户请求生成背景音乐
需要为视频创建配乐或片头音乐
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
WebGL视频特效生成工具，支持滤镜、转场、蒙版及调色。遵循先查目录后生成的原则，提供内置效果应用与自定义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视频生成能力，支持文生视频、图生视频及视频编辑扩展。提交任务并返回ID，需配合进度跟踪使用。
用户希望生成新的视频片段
用户希望对已有视频进行编辑或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
提供文本转语音(TTS)生成、配音/旁白添加替换、音频同步对齐及自定义音效生成功能。支持多提供商音色选择与参数调节，适用于视频制作中的语音资产创建与时间线同步维护。
用户需要基于文本生成语音或旁白
为现有视频或时间线添加、替换或重新制作配音
在视觉内容调整后保持原有配音同步
需要试听或选择特定的TTS音色
需要生成不在库中的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导 Agent 在 ChatCut、Codex 和 Claude Code 等不同插件宿主中，适配并调用各自的表单接口以获取用户结构化输入，确保跨平台兼容性。
需要在不同 IDE 或聊天界面中收集用户结构化数据
需要根据当前运行环境选择正确的表单交互工具
npx skills add ChatCut-Inc/agent-plugin --skill widget-forms -g -y
指导Agent导入本地或下载的媒体文件至ChatCut项目。通过检查现有资产、下载URL、创建导入会话并调用专用脚本上传文件，处理分批次上传及进度等待，确保媒体直接存入存储而非经过后端。
需要导入视频或音频文件到项目中
需要将外部链接的媒体资源下载到本地并导入
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导在ChatCut Desktop中通过ACP或CLI创建和编辑运动图形JSX资产，涵盖内联代码编写、视觉规范对齐及时间轴放置。
需要在项目中创建新的运动图形JSX资产
需要修改或补丁现有的运动图形JSX资产
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
用于导出 ChatCut 项目的最终交付物，支持视频、音频、字幕及 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 插件工具故障、变异拒绝及导入生成渲染错误，指导正确重试与状态处理。
插件工具执行失败
媒体导入或转换异常
内容生成被拒绝
导出渲染报错
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
用于通过文本提示生成原创背景音乐（BGM）的技能。调用submit_music提交任务，利用Mureka模型创建音频资产，适用于视频开场、背景铺底等场景，不支持编辑现有音频。
用户需要为视频生成背景音乐
用户请求创建片头音乐或BGM
用户希望生成特定风格的情绪配乐
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
AI WebGL着色器生成助手，用于视频特效、转场、蒙版及调色。遵循先查目录后生成的原则，支持通过工具管理作业生命周期和素材应用。
用户需要生成或应用视频滤镜/特效
用户需要创建视频转场效果
用户需要进行视频调色或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和Gemini Omni的AI视频生成能力，支持文生视频、图生视频及现有视频编辑扩展，返回任务ID供后续追踪。
用户希望生成视频片段（如文生视频、图生视频）
用户需要对已生成的视频进行修改、编辑或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
提供文本转语音、配音生成及自定义音效功能，支持视频时间轴上的语音同步与替换。
需要生成语音或旁白
为视频添加或替换配音
生成自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导 Agent 在 Codex 和 Claude Code 插件中，通过适配各自的 MCP 或 Elicitation 工具，向用户发起结构化表单输入请求。
需要向用户收集结构化数据
需要在 ChatCut、Codex 或 Claude Code 环境中渲染表单界面
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
为 Claude Code 提供 ChatCut 插件的基础运行上下文，涵盖项目模型、MCP 工具命名空间解析及 OAuth 登录验证流程。确保在调用 ChatCut 编辑或创建视频前正确初始化环境并处理认证问题。
首次调用 ChatCut MCP 工具前
涉及视频编辑且需保持可编辑状态时
ChatCut 工具不可用或未连接时
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics-claude -g -y
多机位视频同步技能，通过转录文本对齐多个摄像机和录音机素材，生成同步主轨道及演讲者跟随剪辑。
多机位/多录制源同步
需要按说话人切换镜头的剪辑
对齐分离的音频与视频
npx skills add ChatCut-Inc/agent-plugin --skill multicam-sync -g -y
ChatCut产品知识库，涵盖UI、功能、积分、订阅及安装指南。用于回答产品相关问题或指导GUI操作，作为任务失败时的回退方案，非项目状态查询。
询问产品功能或使用方法
咨询积分、支付、订阅或定价
请求下载客户端或安装插件
需要手动执行GUI操作
任务失败需引导用户手动完成
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
指导口播、访谈及播客等语音主导型视频的非 trivial 剪辑工作，涵盖去口癖、节奏调整、MG动画叠加、B-roll插入、背景音乐及字幕生成。
需要编辑口播或访谈类视频内容
要求对语音驱动的视频进行去口癖、停顿去除或节奏优化
需要在视频中叠加MG动画、B-roll或添加字幕和背景音乐
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
提供 ChatCut 视频编辑的基础操作上下文，涵盖项目模型、MCP 服务连接及认证故障排查，指导 AI 作为专业视频编辑助手处理剪辑、字幕等任务。
用户需要编辑或创建视频
ChatCut MCP 工具不可用或报错
涉及 ChatCut 项目导入导出
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
多机位视频同步技能，通过转录文本对齐多摄像头及录音素材，生成同步主时间线并可选制作跟随发言人的剪辑草稿。
用户导入多个同场录制的松散片段请求对齐
用户要求多机位/多角度同步
用户希望制作发言人跟随剪辑
涉及摄像机A/B或独立麦克风录音的对齐需求
npx skills add ChatCut-Inc/agent-plugin --skill multicam-sync -g -y
ChatCut产品知识库，用于解答UI、功能、计费及安装问题，并提供GUI操作指引。作为任务失败时的手动操作回退方案。
询问ChatCut产品功能或使用方法
查询积分、订阅、定价或支付方式
需要下载桌面端或安装插件
任务失败需引导用户进行手动操作
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
