klipfolio-automation

klipfolio-automation skill 概览

klipfolio-automation 能做什么

klipfolio-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP toolkit 自动化处理 Klipfolio 相关工作。它的核心并不是把某一套固定的 Klipfolio 流程写死，而是引导 agent 先发现当前可用的 Klipfolio tool schemas，确认账号连接状态，然后再使用正确的 Rube MCP tool calls 执行任务。

当你希望 AI agent 协助处理 Klipfolio 操作时，可以使用它，例如查找可用的 Klipfolio actions、准备 API 风格的输入、检查连接状态，或通过 Composio 构建可重复执行的 dashboard / data workflow 步骤。

最适合的用户与工作流

这个 klipfolio-automation skill 最适合已经在使用 Rube MCP，或愿意通过 Rube MCP 连接 Klipfolio 账号的用户。它适用于 workflow automation 团队、分析运营人员、dashboard 维护者，以及希望让 Claude 协调 Klipfolio actions、而不是每次都手动检查 tool schemas 的开发者。

如果你的任务依赖当前的 Composio schemas，它尤其有用，因为该 skill 明确要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS，而不是猜测字段名称。

核心差异：先发现 schema

klipfolio-automation 最重要的设计选择，是“先搜索工具”的模式。Klipfolio 和 Composio 的 tool schemas 可能会变化，不同操作也需要不同的输入字段。这个 skill 把工具发现纳入常规流程，从而降低自动化流程的脆弱性：

• 使用 RUBE_SEARCH_TOOLS 发现相关的 Klipfolio tools
• 通过 Rube connection management 验证 Klipfolio connection
• 在调用 tools 前，先使用返回的 schemas 和 execution plans
• 尽可能在同一个 session 中继续执行

如何使用 klipfolio-automation skill

klipfolio-automation 的安装与设置背景

在兼容的 skills client 中使用以下命令安装：

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

然后在你的 client 中配置 Rube MCP。源 skill 指向的 MCP server endpoint 是：

https://rube.app/mcp

在期待它产出有用结果之前，请先确认三件事：

1. 你的 client 中可以使用 RUBE_SEARCH_TOOLS。
2. 已经通过 Rube 建立了 Klipfolio connection。
3. connection status 为 ACTIVE。

如果 Klipfolio connection 不是 active，请要求 agent 使用 toolkit klipfolio 对应的 Rube connection-management tool，并按照返回的 authorization link 完成授权。

使用该 skill 时你需要提供的输入

想获得更可靠的 klipfolio-automation usage，不要只说“automate Klipfolio”。你需要告诉 agent 操作目标、目标对象、约束条件，以及期望的输出格式。

较弱的 prompt：

Automate my Klipfolio dashboard.

更好的 prompt：

Use the klipfolio-automation skill. First search Rube tools for current Klipfolio schemas. I need to update a Klipfolio dashboard workflow for our weekly revenue report. Check that the Klipfolio connection is active, identify which available tools can list or update relevant Klipfolio resources, and propose the exact execution plan before making changes. Do not modify anything until I approve the tool and fields.

这类 prompt 效果更好，因为它明确要求 agent 先发现 schemas、遵守审批边界，并把规划和执行分开。

首次运行的实用流程

一个可靠的首次运行模式是：

1. 要求 agent 阅读 composio-skills/klipfolio-automation/SKILL.md。
2. 让它使用具体用例调用 RUBE_SEARCH_TOOLS，例如 "Klipfolio dashboard update" 或 "Klipfolio data source management"。
3. 要求它汇总可用的 tool slugs、必填字段、可选字段和潜在风险点。
4. 确认 Klipfolio connection 处于 active 状态。
5. 在任何 write/update action 之前，先运行低风险的 read/list action。
6. 执行前审查拟定的 payload。

首次需要检查的唯一仓库文件是 SKILL.md；这个 skill 没有随附额外 scripts、resources 或 reference folders，因此大多数实用上下文都来自实时的 Rube tool discovery。

更安全的自动化 prompt 模式

对于接近生产环境的工作，建议使用分阶段 prompt：

Use klipfolio-automation for Workflow Automation. Start by calling RUBE_SEARCH_TOOLS for: [specific Klipfolio task]. Reuse the generated session. Check whether the Klipfolio connection is active. Return a plan with the exact tool slug, required fields, missing information, and risk level. Wait for approval before any action that creates, updates, deletes, or changes Klipfolio assets.

这可以避免一种常见失败模式：agent 自行编造 schema，或在没有验证当前 toolkit 的情况下直接进入写操作。

klipfolio-automation skill 常见问题

klipfolio-automation 适合新手吗？

适合，前提是你能够完成 Rube MCP 连接并按照 auth flow 授权。这个 skill 本身短小直接，但外围工作流需要你理解 Claude 会调用外部 MCP tools。新手应从只读的发现任务开始，并要求 agent 在执行前解释每个 tool。

它和普通的 Klipfolio prompt 有什么不同？

普通 prompt 可能依赖模型对 Klipfolio 或 API 模式的记忆。klipfolio-automation skill 会指示 agent 先向 Rube 查询当前 tool schemas。这让它更适合真实自动化场景，因为在实际执行中，准确的字段、tool names 和 connection state 往往比通用产品知识更重要。

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

如果你不打算连接 Rube MCP、你的 client 无法访问 MCP tools，或者你需要的是离线文档型帮助，就不应使用它。它也不是完整的 Klipfolio dashboard 设计指南；它是一个面向执行的自动化 skill，用来通过 Composio 的 Klipfolio toolkit 完成操作。

它包含自定义 scripts 或 templates 吗？

不包含。仓库证据显示只有一个 SKILL.md，没有随附 scripts、references 或 assets。这让 skill 保持轻量，但也意味着用户应依赖实时的 RUBE_SEARCH_TOOLS 结果和自己的 Klipfolio 上下文，而不是期待现成的 workflow templates。

如何改进 klipfolio-automation skill

用更清晰的目标改进 klipfolio-automation 结果

改进 klipfolio-automation 输出最简单的方法，是用具体任务意图替代含糊的 dashboard 描述。请包含：

• 你关注的 Klipfolio asset type
• action 是 read-only 还是允许写入
• 自动化背后的业务目标
• 已知的 IDs、names、URLs 或 workspace context
• 变更前的审批要求

例如，“find available tools for listing Klipfolio dashboards and report required fields” 比 “help with Klipfolio” 更具可执行性。

避免常见失败模式

最大的风险是猜测 schema。如果 agent 没有先调用 RUBE_SEARCH_TOOLS，应立即停止并引导它回到正确流程。第二个常见问题是 connection drift：agent 可能在确认 Klipfolio connection 为 ACTIVE 之前就开始规划工作流。第三个问题是不安全的写操作；在 create、update 或 delete 操作前，应要求先给出计划并审查 payload。

一个好的防护原则是：先 discovery，再 connection，第三步做 read action，只有审批后才进行 write action。

首次 tool discovery 后继续迭代

第一次 discovery call 之后，要求 agent 基于实际返回的 schema 细化计划：

Based on the discovered Klipfolio tools, identify the safest read-only validation step, list the exact required fields, and tell me what information you still need from me before execution.

这会把 skill 从泛泛的自动化请求，转变为基于 schema 的工作流。

面向维护者的仓库阅读路径

如果你在评估或扩展这个 skill，请从 SKILL.md 开始。检查 frontmatter requirements，尤其是 requires: mcp: [rube]，然后查看 prerequisite、setup、tool discovery 和 core workflow sections。由于没有 supporting files，有意义的改进很可能来自为常见 Klipfolio tasks 添加示例、补充更安全的审批表述，以及为 read-only 和 write workflows 提供 sample prompts。