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 及已上传资产的处理流程。重点说明通过浏览器窗格进行即时导入的机制，以及当窗格不可用或需要云存储支持时的上传回退策略。
用户需要从本地路径导入视频或音频到 ChatCut 项目
用户提供了公开媒体 URL 需要下载或推送到编辑器
用户在聊天中附加了文件并询问如何导入到当前编辑会话
需要检查或复用已在 ChatCut 编辑器中上传的现有资产
npx skills add ChatCut-Inc/agent-plugin --skill asset-import -g -y
指导在Codex 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 模型选择。提供参数配置、参考图管理及进度跟踪功能，用于创建或生成图片。
用户要求生成图片或图像
需要创建视觉素材
npx skills add ChatCut-Inc/agent-plugin --skill image-gen -g -y
诊断 ChatCut 插件工具失败、变异拒绝及导入生成渲染阻塞等错误。依据当前 MCP 工具模式处理冲突、媒体导入、动态图形生成及导出验证，避免无效重试与状态污染，确保操作合规。
插件工具执行报错
内容变异被拒绝
媒体导入或转换失败
动态图形生成异常
导出或渲染任务受阻
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
用于生成和配置 WebGL 视频特效、转场、蒙版及调色的 Shader。遵循先库后生的原则，通过浏览内置资产库应用效果，仅在无匹配项时调用后端任务生成新 Shader。
用户请求添加视频滤镜或特效
需要创建转场效果（如溶解、3D切换）
要求对视频进行调色或应用 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 在 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
指导在Codex ChatCut中直接编写Motion Graphic JSX，通过create_motion_graphic_from_code创建和编辑资产，遵循运行时规范与内联代码要求。
需要创建或修改动态图形组件
使用Codex工具生成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
通过 submit_music 根据文本提示生成原创背景音乐，适用于视频配乐、片头或氛围音乐。需先获取 jobId 并等待完成，后续配合时间轴工具进行剪辑和混音处理。
需要生成背景音乐
创建视频配乐
生成片头音乐
npx skills add ChatCut-Inc/agent-plugin --skill music -g -y
用于生成和编辑 WebGL 视频特效、转场、蒙版及调色的 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模型执行视频生成任务，支持文生视频、图生视频及视频编辑扩展，提交作业并返回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）中适配结构化表单输入，确保正确调用对应工具收集用户信息。
需要在 ChatCut 或 Codex 中向用户请求结构化数据
需要在 Claude Code 中通过 Elicitation 形式获取用户输入
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操作或提供本地化步骤。
询问产品功能、UI布局或使用指南
查询积分、账单、订阅或支付方式
需要下载客户端或安装Agent插件
任务执行失败需引导手动完成
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插件基础技能，为Codex提供项目模型、编辑上下文及MCP连接指南。涵盖视频剪辑全流程支持及认证故障排查，指导用户解决工具不可用问题。
使用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功能或使用方法
用户咨询积分、支付、订阅或定价
需要下载桌面端或安装插件
任务失败需引导手动操作
npx skills add ChatCut-Inc/agent-plugin --skill product-help -g -y
指导口播、访谈及播客等语音主导视频的非 trivial 剪辑，涵盖去口癖、MG动画叠加、B-roll、音乐与字幕处理，提供节奏感知与画面保护等专项建议。
口播视频剪辑
访谈节目后期
去除说话停顿或口癖
为视频添加MG动画
视频播客制作
npx skills add ChatCut-Inc/agent-plugin --skill talking-head-guide -g -y
