cloudconvert-automation

cloudconvert-automation skill 概览

cloudconvert-automation 能做什么

cloudconvert-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 运行 CloudConvert 格式转换工作流。它可以帮助 agent 发现当前可用的 CloudConvert tool schema、验证账号连接状态，并在不臆测过时 API 字段的情况下执行与转换相关的操作。

当你希望 Claude 在支持 MCP 的环境中协助处理 CloudConvert 操作时，这个 cloudconvert-automation skill 尤其有用，例如文件转换规划、创建 job、执行 task，以及基于连接状态的自动化流程。

最适合的用户和使用场景

cloudconvert-automation skill 适合已经在使用，或愿意使用带有 CloudConvert 连接的 Rube MCP 的用户。它尤其适合：

• 通过 CloudConvert 转换文档、图片、音频、视频、压缩包或 Office 文件的团队。
• 需要先检查可用 CloudConvert tools、再进行调用的 agent。
• 输入 schema 可能变化、需要实时发现 tool 能力的工作流。
• 希望建立可复用 CloudConvert 自动化模式，而不是只写一次性 prompt 的用户。

如果你只是想咨询文件格式建议，并不打算通过 Rube MCP 连接 CloudConvert，那么它的价值就没有那么大。

核心差异：先搜索 tools，再执行

这个 cloudconvert-automation skill 的主要价值，不在于提供一份很长的静态操作清单，而在于要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS。这很重要，因为 CloudConvert 的 tool 名称、参数以及推荐执行方案都可能变化。该 skill 会推动 agent 先获取当前 schema，再使用 RUBE_MANAGE_CONNECTIONS 确认 cloudconvert toolkit 已处于可用状态，然后才尝试执行操作。

安装前需要确认什么

安装前，请确认你的客户端支持 MCP servers，并且可以将 https://rube.app/mcp 添加为 MCP endpoint。上游 skill 只有一个核心文件 SKILL.md，没有配套脚本或参考目录，因此接入成本很低。相应的取舍是：具体执行细节必须依赖 Rube 的实时 tool discovery，以及 CloudConvert 已连接账号的状态。

如何使用 cloudconvert-automation skill

cloudconvert-automation 安装环境

从 Composio skills repository 安装该 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill cloudconvert-automation

然后在你的 AI client 中添加 Rube MCP：

https://rube.app/mcp

该 skill 要求 Rube MCP tools 可用，尤其是 RUBE_SEARCH_TOOLS。你还需要通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit cloudconvert 建立有效的 CloudConvert 连接。如果连接未激活，Rube tool 应返回授权链接；请先完成该授权流程，再让 agent 执行转换。

你需要提供哪些输入

为了稳定使用 cloudconvert-automation，不要只说“转换这个文件”。建议提供：

• 源文件位置，或 agent 应该如何访问该文件。
• 当前文件类型和目标输出类型。
• 是否需要关注转换设置，例如 OCR、压缩、页码范围、质量、codec、分辨率或元数据保留。
• 转换后的输出应保存到哪里。
• 文件大小、隐私、覆盖行为、命名规则或批处理方式等约束。

较弱的 prompt 是：

Convert this PDF to Word.

更好的 prompt 是：

Use cloudconvert-automation for Format Conversion. First discover current CloudConvert tools with RUBE_SEARCH_TOOLS, then verify the cloudconvert connection. Convert /uploads/contract.pdf to .docx, preserve layout as much as possible, keep the original filename with -converted, and tell me before overwriting any existing output.

agent 的实用工作流

一份可靠的 cloudconvert-automation 指南应遵循以下顺序：

1. 使用具体转换任务调用 RUBE_SEARCH_TOOLS，不要只发泛泛的查询。
2. 复用或创建 session ID，让后续 tool 调用共享上下文。
3. 使用 RUBE_MANAGE_CONNECTIONS 检查 CloudConvert 连接。
4. 如果连接已激活，选择 Rube 返回的已发现 tool slug 和 schema。
5. 只使用当前 schema 中的字段执行转换方案。
6. 报告 job 状态、输出位置，以及任何被跳过或未确认的假设。

你首先只需要阅读仓库中的 SKILL.md。请重点关注其中的 prerequisites、setup、tool discovery 模式，以及每个工作流执行前都要先搜索 tools 的要求。

提升结果质量的 prompt 模板

调用该 skill 时，可以使用下面的结构：

Use cloudconvert-automation. My goal is [specific conversion]. 
First call RUBE_SEARCH_TOOLS for the current CloudConvert schema. 
Verify the cloudconvert connection is ACTIVE. 
Input: [file/source]. Output: [format/location]. 
Settings: [quality/OCR/page range/etc.]. 
Constraints: [privacy/naming/overwrite/batch behavior]. 
If a required field is missing, ask before executing.

这样既能让 agent 获得足够信息来选择正确的 CloudConvert 操作，又能遵守该 skill 关于先发现实时 schema 的要求。

cloudconvert-automation skill 常见问题

cloudconvert-automation 只能用于文件转换吗？

它围绕 CloudConvert 操作设计，因此格式转换是最主要的适用场景。根据 Rube 在运行时暴露的 CloudConvert tools，它也可能支持相关的 job、task、import、export 或 status 操作。该 skill 有意避免硬编码这些细节，并要求通过 RUBE_SEARCH_TOOLS 发现当前能力。

它比普通 CloudConvert prompt 好在哪里？

普通 prompt 可能会编造 CloudConvert 参数，或假设已经过时的 API 结构。cloudconvert-automation skill 会要求 agent 在执行前先通过 Rube 查询当前 tool slugs、schemas、执行方案和潜在风险。这样可以减少猜测，尤其适合自动化或可重复执行的工作流。

新手可以使用这个 skill 吗？

可以，前提是你能接受添加 MCP server，并完成类似 OAuth 的连接授权流程。这个 skill 本身很小，但它依赖 Rube MCP 可用，并且 CloudConvert toolkit 已完成连接。如果你的客户端无法访问 MCP tools，这个 skill 就不能直接执行转换。

什么时候不该使用这个 skill？

当你需要离线转换、仅本地处理，或工作流必须避免第三方处理文件时，不应使用它。如果你的任务只是学习性质，例如比较文件格式，并不需要实际执行 CloudConvert 操作，也不建议使用。在这些情况下，普通 prompt 或本地转换工具可能更简单。

如何改进 cloudconvert-automation skill

用更完整的任务细节提升 cloudconvert-automation 效果

最常见的失败原因是信息不足。CloudConvert jobs 往往依赖源文件访问方式、目标位置、格式相关选项以及连接状态。要提升结果，请明确说明具体输入、期望输出和操作限制。对于批处理任务，还要说明文件应独立处理、合并、打包成 zip、重命名，还是在出错时跳过。

有意识地处理 schema 和连接失败

如果第一次输出失败，不要只是重复提交同一个 prompt。请让 agent 展示 RUBE_SEARCH_TOOLS 返回了什么、哪些 schema 字段是必填项，以及 RUBE_MANAGE_CONNECTIONS 是否报告 cloudconvert 连接为 ACTIVE。很多问题来自授权缺失、源文件不可用、格式组合无效，或遗漏了必填字段。

在第一次转换后继续迭代

完成初次运行后，根据真实验收标准对输出进行检查并改进工作流。例如，如果 PDF 转 DOCX 后版式丢失，可以修改 prompt，强调优先保留布局，或测试 tool schema 中发现的其他设置。如果视频输出文件过大，可以在已发现 tools 支持的前提下，要求降低 bitrate、resolution 或 compression 设置。

为团队使用强化这个 skill

如果要在团队中重复使用，请在项目说明附近记录你们偏好的 prompt template、批准的输出位置、命名规则、覆盖策略和隐私约束。上游 cloudconvert-automation skill 有意保持轻量，因此真正让它适合生产式 Format Conversion 工作流的，是你们本地的使用规范。