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 (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、已上传）选择浏览器面板或辅助脚本等路径，确保文件正确入库及转录。
用户需要导入视频或音频到ChatCut项目
处理本地文件或公共媒体URL的上传流程
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导在Codex ChatCut中通过直接编写JSX代码创建和编辑动态图形资产，包括内容规划、样式对齐、工具调用及批量处理规范。
需要创建新的动态图形素材
需要修改现有的动态图形组件
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
指导代理通过指定工具提交视频、音频等项目的渲染导出任务，追踪进度并交付最终文件。仅在用户明确要求下载或获取独立成品时触发，确保格式与状态准确无误。
用户请求渲染项目
用户要求下载最终成品
用户需要获取独立的交付文件
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 插件工具失败、变异拒绝及导入渲染错误，提供结构化重试与状态同步策略。
ChatCut 插件操作报错
媒体导入或生成任务失败
视频渲染或导出异常
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
基于文本提示生成原创背景音乐资产的技能。通过submit_music提交任务，适用于视频背景乐、片头曲等场景，需后续使用时间轴工具进行剪辑和同步。
用户需要为视频生成背景音乐
用户需要创建片头或主题音乐
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
AI视频特效生成技能，支持滤镜、转场、遮罩及调色。遵循先查库后生成的原则，提供内置效果应用与自定义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）和自定义音效生成功能，支持为视频添加、替换或同步旁白，适配多语言及多种情感控制参数。
需要生成语音旁白或解说
为视频内容添加或替换配音
生成自定义音效
调整音频与视频画面的同步
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、创建导入会话，并调用upload-media.mjs脚本上传文件。需等待转录和上传完成后再进行后续时间线操作。
用户需要导入视频或音频到项目中
需要将外部链接的媒体转换为项目资产
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
为Codex提供ChatCut视频编辑插件的基础上下文，涵盖项目模型、MCP路由及角色定义，辅助AI作为专业视频剪辑助手处理剪辑、字幕等任务。
使用ChatCut进行视频编辑或创作
涉及本地/附加视频的剪辑、字幕、转录、导出等操作
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics -g -y
指导通过Codex ChatCut工具直接编写Motion Graphic JSX，使用特定API创建或编辑资产，遵循内联源码、可编辑属性及视觉规范，确保设计样式对齐与时间轴实例正确更新。
需要创建动态图形内容
编辑现有的动态图形JSX资产
调整时间轴上的图形实例
npx skills add ChatCut-Inc/agent-plugin --skill create-motion-graphics -g -y
处理ChatCut项目的最终渲染与导出任务，支持视频、音频、字幕及XML格式。通过提交和追踪渲染作业，获取下载链接或本地文件路径，并处理云渲染中的资产导入阻塞问题，确保交付物完整可用。
用户请求渲染视频或音频
用户请求下载最终成品
用户请求导出字幕或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提供结构化错误修复策略，避免无效重试，确保状态一致性并指导用户解决认证或资产访问限制。
插件工具执行报错
内容提交被拒绝
媒体导入或转换失败
渲染导出异常
npx skills add ChatCut-Inc/agent-plugin --skill known-errors -g -y
基于文本提示生成原创背景音乐资产的工具。支持指定风格、情绪和用途，通过异步任务完成生成。适用于视频配音背景乐、开场曲等场景，需配合时间轴工具进行剪辑同步。
需要为视频生成背景音乐
请求创建片头音乐或BGM
希望根据描述生成无版权风险的原创音频
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
视频特效与着色器生成助手，优先通过目录查找内置滤镜、转场和调色效果，匹配失败时调用后端接口生成新着色器，并支持在时间轴上配置效果参数。
用户请求视频滤镜或特效
用户需要添加转场效果
用户要求调整颜色分级或LUT
用户希望生成蒙版或推近镜头效果
npx skills add ChatCut-Inc/agent-plugin --skill shader-gen -g -y
用于处理音视频转录、字幕生成及修复的 Skill。涵盖资产识别、进度监控、转录失败重试、源文本修复及语义编辑引导，确保转录就绪后执行字幕操作。
需要获取视频或音频的转录文本
检查转录任务状态或等待完成
修复错误的转录内容
为语音驱动编辑准备素材
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)、配音生成、声音效果定制及音视频同步对齐功能，支持多提供商和音色选择。
需要生成旁白或配音
为视频添加或替换语音
生成自定义音效
调整语音与画面同步
npx skills add ChatCut-Inc/agent-plugin --skill voice -g -y
指导Agent在不同宿主（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
ChatCut视频编辑插件的基础技能，为Claude Code提供项目模型、MCP服务器配置及登录验证等上下文。作为调用具体编辑工具前的前置准备，确保媒体处理流程正常运行。
首次调用ChatCut MCP工具前
用户提及视频编辑或创建且需保持可编辑状态时
npx skills add ChatCut-Inc/agent-plugin --skill chatcut-plugin-basics-claude -g -y
提供ChatCut产品的知识库，涵盖UI布局、功能使用、积分定价及Pro版升级指南。当用户询问产品细节、需要GUI操作指引或任务失败需手动引导时使用，但不处理实时项目状态查询。
用户询问产品功能、界面布局或使用方法
用户咨询积分、定价或ChatCut Pro升级问题
Agent无法直接执行操作，需引导用户进行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
ChatCut产品知识库，用于解答界面、功能、定价及计费问题，并在代理无法直接操作时提供GUI手动操作引导。
询问产品功能或使用方法
查询积分、价格或订阅信息
需要代理引导完成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
