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 (47)
用于将本地或网络媒体导入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
指导在Codex ChatCut中通过直接编写JSX代码创建、编辑和放置动态图形资产，强调内联源码、样式对齐及视觉验证。
需要创建或编辑动态图形
使用ChatCut工具生成可视化内容
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导 Agent 处理 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动态图形生成技能，通过收集上下文并构建结构化提示词调用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
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
用于验证视频编辑插件修改是否已正确反映在项目结构和时间线输出中。通过结合结构读取与视觉检查（如下载并审查帧图像），确保渲染结果真实有效，避免仅凭元数据或URL误判成功。
需要确认编辑操作后的项目状态
验证视频合成、转场等视觉效果是否正确生成
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）和自定义音效的技能。支持文本转语音、视频配音同步、音轨替换及声音效果生成，适用于多媒体内容创作中的音频处理需求。
需要生成语音旁白或解说
为视频添加或替换配音
保持现有配音与视觉剪辑的同步
试听或选择TTS音色
生成不在库中的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导Agent在ChatCut、Codex和Claude Code等不同插件宿主中，使用适配的MCP工具或API调用表单组件，以结构化方式向用户收集输入信息。
需要向用户收集结构化数据
根据当前运行环境生成特定的表单交互指令
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 工具直接编写 Motion Graphic JSX，涵盖资产创建、编辑及时间轴放置，强调内联源码、样式对齐与视觉验证。
用户请求创建动态图形或动画素材
需要生成或修改 Motion Graphic 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 插件工具故障、变异拒绝及导入生成渲染异常。依据当前 MCP schema 处理冲突、媒体转换失败等问题，避免无效重试，指导用户正确解决认证或项目访问错误。
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视频特效、转场、蒙版及调色的AI Shader工具。遵循先查库后生成的原则，支持通过browse_library检索内置资产，并利用edit_item和track_progress管理效果应用与任务进度。
用户需要为视频添加滤镜或特效
用户请求视频转场效果如淡入淡出
用户需要进行色彩分级或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模型的视频生成技能，支持文生视频、图生视频及视频编辑扩展。提交任务后返回jobId，由track_progress负责状态追踪。
用户希望生成新的视频片段
用户希望对已有视频进行编辑或扩展
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调用，向用户发起结构化表单交互以收集输入信息。
需要引导用户提供结构化数据时
需要替代文本输入进行多字段信息采集时
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
ChatCut产品知识库，解答UI、功能、计费、订阅及下载安装等问题，指导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
为Codex环境下的ChatCut插件提供基础操作上下文，涵盖视频剪辑、字幕处理及项目流转。重点解决MCP工具缺失时的认证问题，指导用户完成登录以恢复服务连接。
使用ChatCut进行视频编辑或创建
ChatCut MCP工具不可用或未加载
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -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
