Agent Skills
› ChatCut-Inc/agent-plugin
ChatCut-Inc/agent-plugin
GitHub用于将本地或网络媒体导入ChatCut项目库。支持通过Claude Code浏览器面板即时拖拽导入，提供自动转录和预览；若需云备份或无面板环境，则回退至上传助手流程，确保资产状态正确以便后续编辑与导出。
安装全部 Skills
npx skills add ChatCut-Inc/agent-plugin --all -g -y
集合内 Skills (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、已上传）选择浏览器面板注入或上传助手等最佳路径，确保状态验证与无缝集成。
用户需要导入视频或音频文件到项目
处理本地文件或聊天附件的媒体导入
将公共媒体URL添加到项目库
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导Agent使用Codex ChatCut工具，通过直接编写JSX代码创建、编辑和放置动态图形资产。强调内联源码、避免硬编码资源、正确调用运行时API及校验视觉结果。
需要创建或修改动态图形组件
在Codex环境中生成Motion Graphic JSX
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
用于将ChatCut项目导出为视频、音频、字幕或XML等最终交付物。通过submit_export提交渲染任务，track_export监控状态，并在完成后提供下载链接或本地文件路径，支持处理媒体导入及透明图形交付。
用户请求渲染视频或音频
用户请求下载最终交付物
用户请求导出字幕或NLE XML
npx skills add ChatCut-Inc/agent-plugin --skill export -g -y
通过后端API生成AI图像，支持gpt-image-2和nano-banana模型选择，处理提示词、参考图及参数配置，返回任务ID供后续追踪。
用户请求生成图片
需要创建视觉素材
基于参考图合成图像
npx skills add ChatCut-Inc/agent-plugin --skill image-gen -g -y
指导诊断 ChatCut 插件工具故障、变异拒绝及导入生成失败，提供基于当前 MCP schema 的错误处理与重试策略。
ChatCut 插件工具调用失败
内容变异被拒绝或冲突
媒体导入或渲染作业异常
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
AI动态图形生成技能，指导Agent通过收集上下文和编写结构化Brief，调用Gemini生成MG动画、修改代码或转换为视频资产。
生成动态图形动画
修改现有MG代码
修复损坏的动画
将MG转换为透明视频
npx skills add ChatCut-Inc/agent-plugin --skill motion-graphic-gen -g -y
用于通过文本提示生成原创背景音乐、片头曲或BGM的AI技能。支持提交生成任务并追踪进度，明确区分生成与后期剪辑边界，指导用户编写包含风格、情绪和用途的提示词以获取合适音频资产。
用户需要为视频生成背景音乐
用户请求创建片头音乐
用户需要无版权风险的原创BGM
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成和配置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
验证ChatCut插件编辑是否准确反映在项目结构和时间线输出中。通过重新读取项目、检查可视化工具生成的帧以及下载并审查源文件，提供结构和视觉证据，确保结果正确无误后再报告成功。
需要验证插件编辑结果时
提交前确认项目结构变更
npx skills add ChatCut-Inc/agent-plugin --skill verification -g -y
提供基于Seedance、Kling等AI模型的文本/图像转视频及视频编辑生成功能，支持多模型选择与参数配置。
用户希望生成视频片段
用户希望对现有视频进行编辑或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
用于生成语音旁白、字幕同步及自定义音效的助手。支持文本转语音，处理视频时间轴上的音频对齐与替换，并提供多语言TTS配置选项。
需要为视频生成配音或旁白
调整视频节奏后需重新对齐现有语音
请求生成特定描述的声音效果
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导 Agent 在不同插件宿主（Codex 或 Claude Code）中正确调用工具以发起结构化表单交互，获取用户输入。
需要向用户收集结构化信息
需要在对话中嵌入表单组件
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
指导在Codex ChatCut中通过代码直接创建和编辑动态图形JSX，强调内联源码、运行时API规范及资产放置流程。
用户要求创建或修改动态图形
询问Codex Motion Graphics的编写规范
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
通过 submit_music 根据文本提示生成原创背景音乐资产。适用于视频配乐、片头或 BGM 需求，支持风格与情绪描述，强调生成后需配合时间轴工具进行剪辑处理。
用户需要为视频生成背景音乐
用户请求创建片头音乐或 BGM
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成和配置WebGL视频特效、转场、蒙版及调色的AI Shader工具。遵循先查库后生成的原则，支持通过API提交生成任务并管理生命周期，适用于视频后期处理场景。
用户请求视频滤镜或特效
需要添加转场效果
要求调整颜色分级或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视频生成能力，支持文生视频、图生视频及现有视频剪辑扩展。
用户希望生成新的视频片段
用户需要对已有视频进行编辑或扩展
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
用于生成语音旁白、TTS音频及自定义音效，支持视频配音、音画同步及音色选择。
需要生成文本转语音
为视频添加或替换旁白
调整音画同步
生成自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导Agent在Codex和Claude Code插件中，通过特定MCP工具或API调用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
作为Claude Code使用ChatCut MCP服务器的强制前置技能，负责初始化项目上下文、验证MCP连接状态及处理OAuth认证登录流程。
首次调用ChatCut工具前
涉及视频编辑或创建且需保持可编辑性时
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操作指引作为Agent无法执行时的回退方案，并澄清不支持实时项目状态查询。
用户询问ChatCut产品功能、界面布局或使用方法
用户咨询积分余额、计费、订阅计划或支付方式
用户需要下载桌面版或安装插件
任务失败需引导用户在界面上手动完成操作
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
指导口播、访谈等语音主导视频的非平凡剪辑，涵盖去口癖、MG动画、B-roll、字幕及背景音乐处理，提供节奏感知与画面保护等专业编辑建议。
用户需要对口播或访谈类视频进行深度剪辑
用户请求去除口癖、添加MG动画或调整视频节奏
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
作为 Codex 中 ChatCut 视频编辑插件的基础上下文，提供项目模型、MCP 路由及认证故障排查指南。用于指导 AI 处理视频剪辑、字幕及导出等任务，并在工具不可用时引导用户重新登录。
使用 ChatCut 进行视频编辑或创建
ChatCut 工具缺失或连接异常需排查
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
用于多机位视频与独立音频录音的自动同步、结构分析及基于讲话人跟踪的剪辑。通过转录文本对齐素材，生成同步主时间线及演讲者跟随草稿。
多机位/多录制源同步
讲话人跟随剪辑
不同步的音视频素材对齐
npx skills add ChatCut-Inc/agent-plugin --skill multicam-sync -g -y
ChatCut产品知识库，解答UI、功能、计费及订阅问题，指导桌面端下载与插件安装，并在任务失败时提供手动操作指引。
询问产品功能或使用方法
咨询积分、支付或订阅详情
需要下载软件或安装插件
任务失败需手动操作指引
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
