convertapi-automation
作者 ComposioHQconvertapi-automation 帮助 Claude 通过 Composio Rube MCP 运行 ConvertAPI 格式转换工作流，支持工具发现、连接检查和基于 schema 的执行。
评分：66/100。适合收录到目录中，但能力范围有限：它为 agent 提供了足够清晰的触发条件，以及基于 Rube 执行 ConvertAPI 任务的模式，但大多数具体操作细节仍依赖实时工具发现。目录用户如果已经在使用 Rube MCP，并希望获得一个轻量的 ConvertAPI 自动化封装，可以考虑它；但不应期待它是一个自包含的工作流库。
- 有效的 frontmatter 明确声明了 `rube` MCP 要求，并说明通过 Composio/Rube 进行 ConvertAPI 自动化。
- 前置条件和设置步骤说明了所需的 Rube MCP endpoint、ConvertAPI connection，以及 ACTIVE 连接检查。
- 该技能反复要求 agent 先调用 `RUBE_SEARCH_TOOLS`，有助于减少使用当前 ConvertAPI 工具时对 schema 的猜测。
- 未提供支持文件、脚本、README 或安装命令；采用这项技能几乎完全依赖 SKILL.md。
- 该技能本身没有记录具体的 ConvertAPI 操作或 schema，因此 agent 在执行前必须依赖实时的 RUBE_SEARCH_TOOLS 发现。
convertapi-automation skill 概览
convertapi-automation 能做什么
convertapi-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行 ConvertAPI 格式转换工作流。它不会让 agent 猜测工具名称，也不会硬编码请求结构；相反，这个 skill 会要求 agent 先发现当前的 ConvertAPI tool schemas，验证用户的 ConvertAPI 连接，然后再通过 Rube 执行转换任务。
因此，当你希望 AI agent 帮你处理可重复的文件转换操作，而不只是解释 ConvertAPI 怎么用时，convertapi-automation skill 会更有价值。
最适合的用户和任务
如果你的工作流需要通过 ConvertAPI 转换文档、图片、电子表格、演示文稿或其他受支持的文件类型，并且希望 Claude 安全地协调 tool call，那么可以把 convertapi-automation 用于 Format Conversion。它适合已经在支持 MCP 的客户端中工作、并希望 agent 负责工具发现、连接检查和执行规划的用户。
它尤其适用于这类任务：“把这个 DOCX 转成 PDF”“把上传的图片合并成一个 PDF”，或者“为一批文件准备转换工作流”。前提是当前 Composio toolkit 已经暴露了所需的 ConvertAPI 操作。
这个 skill 的不同之处
它最核心的差异点是“先搜索工具”的规则。上游 skill 明确要求在执行前先调用 RUBE_SEARCH_TOOLS，这样 agent 会使用当前 schemas，而不是依赖过期示例。这一点很重要，因为 MCP tool names、parameters 和可接受的 input formats 都可能变化。
这个 skill 很小而且聚焦：没有额外脚本、示例或参考目录。它的价值在于为 ConvertAPI automation 强制执行正确的 Rube MCP 工作流。
安装前需要先确认的限制
安装前，请确认你的客户端支持 MCP，能够添加 Rube MCP，并且可以通过 RUBE_MANAGE_CONNECTIONS 完成 ConvertAPI 连接认证。如果你需要的是独立 CLI 转换器、离线转换，或者一个包含大量辅助脚本的仓库，那么这个 skill 对你的用途来说可能过于轻量。
如何使用 convertapi-automation skill
convertapi-automation 安装环境
按常规 skills 工作流，从 ComposioHQ/awesome-claude-skills 仓库安装该 skill，例如：
npx skills add ComposioHQ/awesome-claude-skills --skill convertapi-automation
然后在你的 AI 客户端中添加以下地址来配置 Rube MCP：
https://rube.app/mcp
这个 skill 需要 Rube tools，尤其是 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。安装后，在让 agent 执行转换前，先确认 RUBE_SEARCH_TOOLS 可以正常响应。
必需的连接与发现流程
一个好的 convertapi-automation 使用模式是：
- 让 agent 针对具体 ConvertAPI 任务调用
RUBE_SEARCH_TOOLS。 - 让它通过
RUBE_MANAGE_CONNECTIONS检查 ConvertAPI 连接。 - 如果连接状态不是
ACTIVE，完成返回的认证流程。 - 让 agent 使用发现到的 schema 运行选定的 ConvertAPI tool。
- 检查返回的文件、URL 或转换结果。
不要跳过工具发现。这个 skill 的核心指令就是先搜索工具，因为最新的 tool slug 和 parameter schema 应该来自 Rube，而不是来自记忆。
用更强的 prompt 获得更好的转换结果
一个较弱的 prompt 是：
Convert my file to PDF.
更适合 convertapi-automation 的 prompt 是：
Use convertapi-automation. First run
RUBE_SEARCH_TOOLSfor “convert DOCX to PDF with preserved layout.” Check my ConvertAPI connection status. If active, convert the attachedcontract.docxto PDF. Preserve formatting, return the output file link, and tell me which tool slug and required fields were used.
对于批量任务或接近生产环境的工作，请说明源格式、目标格式、文件数量、文件是附件还是基于 URL、输出命名规则，以及任何质量要求，例如页面尺寸、OCR、压缩、图片分辨率或版式保留。
优先阅读的仓库文件
这个 skill 只有一个重要源文件：
composio-skills/convertapi-automation/SKILL.md
阅读它可以确认所需的 MCP server、连接工作流和工具发现模式。仓库中没有内置脚本或示例可供检查，因此你的配置信心应来自两点：你的 MCP 客户端能否暴露 Rube tools，以及 ConvertAPI 认证是否成功。
convertapi-automation skill 常见问题
convertapi-automation 只适用于 ConvertAPI 吗？
是的。这个 skill 的范围限定为通过 Rube MCP 使用 Composio 的 ConvertAPI toolkit 执行 ConvertAPI 操作。它不是通用文件转换框架，也不会添加 LibreOffice、ImageMagick 或 Pandoc 等本地转换器。
可以不使用 Rube MCP 吗？
不可以。这个 skill 声明了对 rube 的 MCP 依赖。如果 RUBE_SEARCH_TOOLS 不可用，工作流就无法遵循自身的设置和发现要求。在这种情况下，普通 prompt 也许仍能描述转换计划，但无法通过这个 skill 执行 ConvertAPI 操作。
它比普通 prompt 好在哪里？
普通 prompt 可能会编造 ConvertAPI 参数，或依赖过时示例。convertapi-automation 会要求 agent 先发现当前 tools，检查活动连接，并使用返回的 schema。对于依赖实时工具执行的任务，这能减少猜测。
什么时候不应该使用这个 skill？
如果你需要离线转换、严格的本地数据处理、自定义后处理脚本，或一个已经实现重试和日志的完整批处理流水线，就不要使用它。convertapi-automation skill 是一个轻量级执行指南，不是完整的转换应用。
如何改进 convertapi-automation skill
先改进输入，再怀疑工具
大多数糟糕结果都来自转换请求描述不充分。请告诉 agent 源格式、目标格式、文件位置、期望输出名称、质量约束和任何特殊选项。例如：
Convert three attached PNG files into one PDF, in filename order, A4 portrait, no compression if avoidable, and return one downloadable output.
这比“make a PDF”更好，因为它给发现到的 ConvertAPI tool 提供了足够清晰的意图，便于正确映射字段。
留意常见失败模式
常见阻塞包括：Rube MCP 未配置、ConvertAPI 连接未激活、不支持的源格式与目标格式组合、缺少文件访问权限，或者因为跳过 RUBE_SEARCH_TOOLS 导致 schema 不匹配。如果第一次运行失败，请先让 agent 报告发现到的 tool slug、必填字段、已提供字段，以及准确的连接状态，再进行重试。
根据第一次输出继续迭代
第一次转换完成后，检查输出的版式、大小、分辨率、文本提取效果和页面顺序。然后用具体修正来优化 prompt：
Retry with higher image quality and keep the original page dimensions.
或者：
The output order is wrong; sort files by numeric suffix before converting.
这样可以把 convertapi-automation 从一次性转换器变成一个可控工作流。
为团队补充 convertapi-automation 使用规范
如果你的团队经常使用这个 skill，请在你们自己的项目说明中记录批准使用的格式、命名规范、存储位置、隐私规则和重试策略。上游 skill 有意保持最小化，因此本地指导可以在不改变“discover, connect, execute”核心模式的前提下，提高安全性和一致性。