craftmypdf-automation

craftmypdf-automation skill 概覽

craftmypdf-automation 的用途

craftmypdf-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP 執行 Craftmypdf PDF 產生與文件自動化任務。它不是讓代理猜測工具名稱或硬寫 API 結構；這個 skill 的核心指令是先用 RUBE_SEARCH_TOOLS 探索目前可用的 Craftmypdf 工具，再依照回傳的 schema 執行工作流程。

當你希望 AI 代理協助使用 Craftmypdf template、資料 payload、匯出或相關文件流程來建立或自動化 PDF，同時又想對齊即時的 Composio toolkit，而不是依賴過期範例時，就適合使用這個 skill。

最適合的使用者與任務

craftmypdf-automation skill 最適合已經搭配 MCP tools 使用 Claude，且需要可重複 PDF Processing 工作流程的開發者、自動化建置者與營運團隊。常見任務包括從結構化資料產生發票、證書、報表、對帳單、訂單文件，或其他以 template 為基礎的 PDF。

當確切的 Craftmypdf 操作可能因帳號、連線狀態或 toolkit schema 而異時，它特別有用。這個 skill 會要求代理在動作前先檢查目前啟用的工具目錄，能降低 Composio 更新參數或 tool slug 後造成呼叫失敗的風險。

主要差異：以 schema 為優先的執行方式

它的重要差異不在於提供大量 helper scripts；這個 repository 只有一個 SKILL.md。它的價值在於流程設計：連接 Rube MCP、確認 Craftmypdf 連線、搜尋可用工具、檢查目前 schema，然後才執行文件任務。

因此，craftmypdf-automation 是一個輕量的 orchestration skill，而不是完整的 PDF 應用程式。如果你想讓代理在 Craftmypdf 自動化上有更安全的行為，適合安裝它。若你期待的是離線 PDF rendering、本機 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 才算準備好用於 production。

請先閱讀 composio-skills/craftmypdf-automation/SKILL.md。目前這個 skill 沒有額外的 scripts/、rules/、references/ 或 resources/ 資料夾，因此操作指引集中在該檔案中。

你需要提供給 skill 的輸入

若要讓 craftmypdf-automation 發揮效果，請提供真實的文件目標，而不只是說「做一份 PDF」。有用的輸入包括：

• Craftmypdf template name 或 ID（若已知）
• 你需要的輸出格式，例如 PDF download URL 或 stored file
• 結構化資料 payload，包含必填欄位
• 這是測試執行還是 production document
• 產生檔案的命名規則
• 錯誤處理期望，例如缺少欄位時重試或停止

較弱的 prompt 是：「Generate an invoice PDF。」

較好的 prompt 是：「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。」

建議工作流程

每次執行都先從工具探索開始：

RUBE_SEARCH_TOOLS，搭配像是「generate PDF from Craftmypdf template with JSON data」這類 use case。

接著用 RUBE_MANAGE_CONNECTIONS 檢查 toolkit craftmypdf 的連線。如果尚未啟用，請先完成授權再繼續。之後，請代理把你的目標對應到探索到的 tool schema，並在執行前顯示預計呼叫內容；production documents 尤其應該這樣做。

若是可重複的工作流程，請保存一份已驗證可用的 prompt，內容包含 template ID、必填資料欄位、輸出期望與驗證規則。即使是已保存的工作流程，這個 skill「先搜尋工具」的模式仍然重要，因為 Composio tool schemas 可能會變更。

craftmypdf-automation skill 常見問題

craftmypdf-automation 適合初學者嗎？

如果你已經能使用 Claude MCP，且可以完成 Composio/Rube connection flow，那它對初學者算友善。但它不是無程式碼 PDF designer。你仍需要了解自己的 Craftmypdf templates，並提供有效的文件資料。

初學者應從單一測試 template 與非敏感範例資料開始。請代理探索工具、說明找到的 schema，並在呼叫執行工具前顯示預計使用的 payload。

這比一般 prompt 好在哪裡？

一般 prompt 可能會幻覺出 Craftmypdf API 名稱，或依賴過期範例。craftmypdf-automation skill 會明確指示代理先呼叫 RUBE_SEARCH_TOOLS，並使用 Rube MCP 回傳的即時 schema。這就是主要的可靠性提升。

這個 skill 也把連線檢查納入工作流程，有助於區分 prompt 錯誤與設定問題，例如 Craftmypdf 連線未啟用。

什麼情況不該使用這個 skill？

如果你需要完全本機端的 PDF 產生、不透過 Craftmypdf 的自訂 PDF rendering，或是包含 scripts 與 tests 的完整封裝整合，就不該使用它。目前這個 skill 是精簡的 MCP 工作流程指南，不是 SDK wrapper。

如果你無法連接 Rube MCP，或無法授權 Craftmypdf toolkit，它也不適合。缺少這些前置條件時，代理就無法探索或執行相關工具。

如何改進 craftmypdf-automation skill

改進 craftmypdf-automation prompts

改善 craftmypdf-automation 結果最快的方法，是提供完整的文件脈絡。請包含業務目的、template identifier、必填欄位、範例資料與預期輸出。也要告訴代理是否可以自行假設，或遇到缺漏值時必須先暫停詢問。

對於 production 工作流程，請加入限制，例如：「Do not send the tool call until you have shown the mapped payload」，或「Validate that every template field has a corresponding data value」。這些指示能降低 PDF 格式錯誤與意外送出的風險。

常見失敗模式與預防方式

多數失敗來自三個原因：Craftmypdf 連線未啟用、跳過工具探索，或 payload 資料不完整。要避免這些問題，請把最初步驟寫清楚：搜尋工具、檢查連線、檢查 schema、對應欄位，然後才執行。

另一個常見問題，是把 template fields 當成可有可無。如果你的 template 需要巢狀資料、line items、日期、幣別或 image URLs，請提供具代表性的 JSON。當範例資料越接近真實 production payload，代理就能更準確地進行資料對應。

第一次輸出後持續調整

第一次 PDF 執行後，請同時檢查產生的文件與 tool-call payload。如果版面內容缺失，應更新資料對應，而不是重寫整個工作流程。如果選錯工具，請用更具體的 use case 重新執行 RUBE_SEARCH_TOOLS，例如「create PDF from existing Craftmypdf template and return export URL」。

若要讓團隊長期穩定使用，請為每種文件類型維護一份簡短的內部 prompt recipe：template ID、必填欄位、sample payload、驗證清單與預期回應格式。這能把 craftmypdf-automation skill 從一次性的輔助工具，變成可重複使用的 PDF 自動化工作流程。