craftmypdf-automation

craftmypdf-automation skill 概览

craftmypdf-automation 能做什么

craftmypdf-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 运行 Craftmypdf PDF 生成与文档自动化任务。它的核心指令不是猜测工具名称，也不是硬编码某个 API 结构，而是先用 RUBE_SEARCH_TOOLS 发现当前可用的 Craftmypdf tools，再根据返回的 schemas 执行工作流。

当你希望 AI agent 帮你基于 Craftmypdf templates、data payloads、exports 或相关文档流程来创建或自动化 PDFs，并且希望它始终对齐实时的 Composio toolkit，而不是依赖过期示例时，就适合使用这个 skill。

最适合的用户和任务

craftmypdf-automation skill 最适合已经在 Claude 中使用 MCP tools，并且需要可重复 PDF Processing 工作流的开发者、自动化搭建者和运营团队。典型任务包括从结构化数据生成 invoices、certificates、reports、statements、order documents，或其他基于 template 的 PDFs。

当具体的 Craftmypdf 操作会因账号、连接状态或 toolkit schema 而变化时，它尤其有用。这个 skill 会促使 agent 在执行前先检查当前活跃的 tool catalog，从而在 Composio 更新参数或 tool slugs 时，减少调用失败。

核心差异：先看 schema，再执行

它的重要差异不在于拥有大量 helper scripts；这个 repository 只有一个 SKILL.md。它的价值在流程上：连接 Rube MCP，验证 Craftmypdf connection，搜索可用 tools，检查当前 schemas，然后才运行文档任务。

因此，craftmypdf-automation 更像是一个轻量级编排 skill，而不是完整的 PDF 应用。如果你想让 agent 在 Craftmypdf automation 场景中表现得更安全、更稳妥，可以安装它。不要期待它提供离线 PDF 渲染、本地 CLI 或内置 templates。

如何使用 craftmypdf-automation skill

craftmypdf-automation 的安装与配置路径

要从 directory repository 安装这个 skill，请使用：

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

然后在你的 client 中配置 Rube MCP endpoint：

https://rube.app/mcp

这个 skill 需要 rube MCP server。发起 PDF 工作流之前，先确认 RUBE_SEARCH_TOOLS 可用。接着使用 RUBE_MANAGE_CONNECTIONS，toolkit 设为 craftmypdf；如果连接未激活，就完成返回的 auth flow。只有当 Craftmypdf connection status 为 ACTIVE 时，这个 skill 才适合进入生产使用。

请先阅读 composio-skills/craftmypdf-automation/SKILL.md。当前 skill 中没有额外的 scripts/、rules/、references/ 或 resources/ 文件夹，因此所有操作指导都集中在这个文件里。

你需要提供哪些输入

要让 craftmypdf-automation 用得更稳，不要只说“make a PDF”，而要给 agent 真实的文档目标。实用输入包括：

• Craftmypdf template name 或 ID（如果已知）
• 你需要的输出格式，例如 PDF download URL 或 stored file
• structured data payload，包括必填字段
• 这是 test run 还是 production document
• 生成文件的命名规则
• 错误处理预期，例如遇到缺失字段时 retry 还是 stop

较弱的提示词是：“Generate an invoice PDF.”

更好的提示词是：“Use craftmypdf-automation for PDF Processing. First discover current Craftmypdf tools with Rube. Check the Craftmypdf connection. Generate a PDF from template invoice_v3 using this JSON order data. Return the tool used, the final payload shape, and the generated PDF link. Do not invent missing customer fields; ask me if required fields are absent.”

推荐工作流

每次运行都先从 tool discovery 开始：

RUBE_SEARCH_TOOLS with a use case such as “generate PDF from Craftmypdf template with JSON data.”

然后用 RUBE_MANAGE_CONNECTIONS 验证 toolkit craftmypdf 的连接状态。如果 inactive，先完成认证再继续。之后，让 agent 将你的目标映射到发现的 tool schema，并在执行前展示计划调用；对于 production documents 尤其应该这样做。

对于可重复工作流，保存一份已验证可用的 prompt，其中包含 template ID、required data fields、output expectations 和 validation rules。即使是保存过的工作流，这个 skill 的“先搜索 tools”模式仍然重要，因为 Composio tool schemas 可能变化。

craftmypdf-automation skill 常见问题

craftmypdf-automation 适合新手吗？

如果你已经可以使用 Claude MCP，并且能够完成 Composio/Rube connection flow，那么它对新手是友好的。它不是 no-code PDF designer。你仍然需要理解自己的 Craftmypdf templates，并提供有效的 document data。

新手建议从单个 test template 和不敏感的 sample data 开始。让 agent 先发现 tools，解释它找到的 schema，并在调用执行 tools 之前展示 planned payload。

它比普通 prompt 好在哪里？

普通 prompt 可能会幻觉出不存在的 Craftmypdf API 名称，或依赖过时示例。craftmypdf-automation skill 明确要求 agent 先调用 RUBE_SEARCH_TOOLS，并使用 Rube MCP 返回的实时 schema。这是它最主要的可靠性提升。

这个 skill 还把 connection check 编入工作流，有助于区分 prompt 写错和设置问题，例如 Craftmypdf connection 未激活。

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

如果你需要纯本地 PDF 生成、不通过 Craftmypdf 的自定义 PDF 渲染，或带 scripts 和 tests 的完整打包集成，就不要使用它。当前 skill 是一个紧凑的 MCP 工作流指南，不是 SDK wrapper。

如果你无法连接 Rube MCP，或无法授权 Craftmypdf toolkit，它也不适合。没有这些前置条件，agent 就无法发现或执行相关 tools。

如何改进 craftmypdf-automation skill

改进 craftmypdf-automation prompts

提升 craftmypdf-automation 结果最快的方法，是提供完整的文档上下文。包括业务目的、template identifier、required fields、sample data 和 expected output。明确告诉 agent：它是否可以做假设，还是在缺少值时必须暂停询问。

对于生产工作流，可以增加这类约束：“Do not send the tool call until you have shown the mapped payload,” 或 “Validate that every template field has a corresponding data value.” 这些指令可以减少格式错误的 PDFs 和意外提交。

需要避免的常见失败模式

大多数失败来自三个原因：Craftmypdf connection 未激活、跳过 tool discovery，或 payload data 不完整。要预防这些问题，就把最初步骤写清楚：search tools、check connection、inspect schema、map fields，然后再 execute。

另一个常见问题，是把 template fields 当成可选项。如果你的 template 需要 nested data、line items、dates、currency 或 image URLs，请提供有代表性的 JSON。当 sample 更接近真实 production payload 时，agent 才能更准确地映射数据。

首次输出后继续迭代

第一次 PDF 运行后，同时检查生成的 document 和 tool-call payload。如果版面内容缺失，优先更新 data mapping，而不是重写整个工作流。如果选错了 tool，就用更具体的 use case 重新运行 RUBE_SEARCH_TOOLS，例如 “create PDF from existing Craftmypdf template and return export URL.”

为了让团队长期稳定使用，建议为每种 document type 维护一份简短的内部 prompt recipe：template ID、required fields、sample payload、validation checklist 和 expected response format。这样可以把 craftmypdf-automation skill 从一次性助手变成可重复的 PDF automation workflow。