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 及已上传资源的智能路由选择。优先通过浏览器面板直接导入以实现即时预览和转录，仅在面板不可用时回退至脚本上传，避免重复导入。
需要导入视频或音频到项目
处理本地媒体文件或公共 URL
检查资源是否已存在以避免重复
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导 ACP 或本地 CLI 在 ChatCut Desktop 中通过内联 JSX 直接创建、编辑和放置动态图形资产，涵盖视觉对齐、输入确认及时间轴操作。
需要创建新的动态图形 JSX 资产
需要编辑现有的动态图形 JSX
需要将动态图形放置在时间轴上
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导在 ChatCut 项目中执行视频、音频及字幕的最终渲染与导出。涵盖提交导出任务、跟踪状态、处理下载链接及解决云渲染介质障碍，确保交付符合用户意图的独立成品文件。
用户请求最终渲染或下载
需要生成独立交付物（视频/音频/字幕）
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
基于文本提示生成原创背景音乐资产的技能，支持风格、情绪等参数控制。适用于视频配音背景乐、片头曲等场景，需配合时间轴工具完成剪辑与同步。
用户需要为视频生成背景音乐
用户请求创建片头音乐或氛围音乐
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
AI WebGL 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等AI模型生成或编辑视频片段，支持文生视频、图生视频及参考引导生成。提交任务后返回jobId，需配合track_progress技能查询状态。
用户希望根据文本描述生成视频
用户希望基于图片生成视频
用户需要修改、扩展或替换现有视频内容
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
指导 Agent 在 ChatCut、Codex 和 Claude Code 等不同插件宿主中，适配并调用各自的表单接口以获取用户结构化输入，确保跨平台兼容性。
需要在不同 IDE 或聊天界面中收集用户结构化数据
需要根据当前运行环境选择正确的表单交互工具
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
指导在ChatCut Desktop中通过ACP或本地CLI直接编写和编辑运动图形JSX资产，涵盖内联代码创作、视觉对齐、时间轴放置及状态验证。
需要创建新的运动图形JSX资产
需要修改现有的运动图形JSX
需要将运动图形放置在视频时间轴上
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
用于导出 ChatCut 项目的最终成品，包括视频、音频、字幕等。通过 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
用于通过文本提示生成原创背景音乐资产的技能。支持描述风格、情绪等，提交后异步生成音频，需配合时间轴工具进行剪辑和同步。
用户需要为视频生成背景音乐
用户请求创建开场音乐或 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 等 AI 模型执行文本或图像到视频的生成任务，支持视频剪辑、扩展及修改。提交作业并返回 jobId，用于处理多媒体内容创作需求。
用户希望生成视频片段
需要对现有视频进行编辑、扩展或修改
npx skills add ChatCut-Inc/agent-plugin --skill video-gen -g -y
将ChatCut结构化表单语义映射至Codex和Claude Code插件宿主，支持文本、选择、音频预览及显式同意等字段类型转换。
需要跨平台适配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 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操作引导和任务失败时的手动步骤兜底，支持本地化界面指引，不处理实时项目状态查询。
询问产品功能或使用方法
查询积分、价格或订阅信息
需要下载桌面版或安装插件
任务失败需人工介入指导
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
提供文本转语音(TTS)、声音克隆、旁白同步及自定义音效生成功能。支持多提供商，强调与视频时间轴的对齐维护，适用于配音、解说及音频资产生成场景。
需要生成语音或旁白
进行声音克隆
处理视频旁白同步
生成自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
为Codex提供ChatCut插件的基础运行上下文，涵盖项目模型、MCP服务路由及工具缺失时的认证排查指南，作为视频编辑辅助工作的通用基座。
使用Codex进行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、功能、计费及订阅问题，指导桌面端下载与插件安装。作为任务失败时的GUI操作回退指南，不包含实时项目状态查询。
用户询问ChatCut产品功能、UI布局或使用方法
用户咨询积分、定价、支付、订阅或ChatCut Pro相关问题
用户需要下载ChatCut Desktop或安装Agent Plugin
当前任务失败，需要引导用户通过UI手动完成操作
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
提供文本转语音、声音克隆及音效生成功能，支持为视频添加配音、保持音画同步及自定义音效。
生成语音旁白或解说
克隆授权声音
生成自定义音效
视频配音与音画同步
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
