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或已上传状态选择最佳路径（Browser-pane优先），确保正确处理和验证上传状态。
需要将本地视频或附件导入ChatCut项目
处理公共媒体URL的导入
检查并复用编辑器中已存在的资产
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导在ChatCut环境中通过内联JSX直接创建、编辑和放置动态图形资产，强调使用专用工具而非生成器，确保内容可编辑并遵循设计约束。
需要在ChatCut中创建新的动态图形JSX代码
需要修改现有的动态图形JSX资产
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模型。提交任务后返回jobId，可查询进度。支持自定义比例、尺寸及参考图，需确认参数后再执行。
用户要求生成图片
需要创建视觉素材
基于提示词或参考图合成图像
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工具，涵盖从风格对齐、提示词构建到视频资产转换的全流程。
需要制作MG动画
修改现有MG代码
修复损坏动画
将MG转换为透明背景视频
npx skills add ChatCut-Inc/agent-plugin --skill motion-graphic-gen -g -y
用于通过文本提示生成原创背景音乐音频资产。支持指定风格、情绪和用途，生成后需配合时间轴工具进行剪辑与同步，不处理现有音频编辑。
用户需要为视频生成背景音乐
用户请求创建新的音乐素材或开场曲
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成WebGL视频特效、转场、蒙版及调色的AI 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
验证ChatCut插件编辑结果，通过检查项目结构和时间线视觉帧确保修改生效。
需要确认插件编辑是否反映在项目结构中
需要验证时间线输出和可见性
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音色
生成自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导Agent在ChatCut、Codex及Claude Code等不同插件宿主中，适配并调用各自支持的表单组件（如ask_followup_questions或show_widget）以获取用户结构化输入。
需要从用户处收集结构化数据
需要向用户展示表单进行交互
npx skills add ChatCut-Inc/agent-plugin --skill widget-forms -g -y
用于将本地、附件或下载的媒体文件导入ChatCut项目。通过外部连接器检查现有资产、下载URL、创建会话并调用专用脚本上传，处理分批次上传及进度等待，确保合规性。
需要将本地视频或音频文件导入到ChatCut项目中
用户希望从公共URL下载媒体并导入项目
需要验证媒体是否已存在于当前项目中
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
为Codex提供ChatCut视频编辑插件的基础上下文，包括项目模型、MCP路由规则及操作边界。指导Agent作为专业视频编辑助手，通过标准化工具链执行剪辑、字幕、导出等任务，确保与浏览器端编辑器状态同步。
用户请求使用ChatCut进行视频编辑或创作
需要访问ChatCut项目、时间线或资产库时
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
指导在ChatCut环境中通过Codex直接编写和编辑Motion Graphic JSX代码。涵盖创建新资产、修改现有代码及时间轴放置，强调内联传递源码并遵循特定工具约束。
需要在ChatCut中创建动态图形素材
需要修改现有的Motion Graphic JSX代码
需要将动态图形放置或更新到时间轴
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导如何导出ChatCut项目为视频、音频等最终交付物。包括调用submit_export提交任务，使用track_export跟踪状态，处理本地下载或URL返回，以及字幕和MG素材的特殊导出逻辑。
用户请求渲染或下载最终成品
需要导出视频、音频、字幕或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或音乐床
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
WebGL视频特效、转场、蒙版及调色滤镜的AI着色器生成技能。遵循目录优先原则，先检索内置资产，再调用后端生成任务，并支持通过编辑项应用效果参数。
用户请求视频特效或滤镜
用户需要添加转场效果
用户希望创建蒙版或遮罩
用户要求进行颜色分级
npx skills add ChatCut-Inc/agent-plugin --skill shader-gen -g -y
提供视频音频转录全流程支持，涵盖资产检查、进度跟踪、字幕管理及转录修复。指导Agent处理ASR状态等待、失败重试及语义编辑设置，确保转录就绪后正确调用相关工具。
需要获取视频或音频的转录文本
检查媒体资产的转录进度或状态
修复错误的转录源文本
为语音驱动的视频编辑准备素材
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)及自定义音效生成能力，支持为视频、时间线添加或替换旁白，并处理音画同步与节奏调整。
需要生成语音旁白或解说
为现有视频添加或替换配音
调整画面后保持配音同步
试听不同TTS音色
生成不在库中的自定义音效
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导Agent在不同插件宿主中通过结构化表单收集用户输入。区分Codex使用MCP工具，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工具前
涉及视频编辑或创建且需保持可编辑状态时
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics-claude -g -y
提供ChatCut产品知识库，解答界面、功能、计费及Pro版问题。指导无法直接执行的操作或任务失败时的手动GUI步骤，排除项目状态查询。
询问产品功能或界面操作
咨询积分、定价或订阅计划
需要引导用户进行手动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产品知识库，解答界面、功能、积分、定价及Pro版问题。指导无法直接执行的操作或任务失败时的手动GUI步骤，排除实时项目状态查询。
询问产品功能或界面操作
咨询积分、定价或订阅计划
需要引导用户进行手动GUI操作
任务失败后的回退指导
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
