api-bible-automation
作者 ComposioHQapi-bible-automation 可帮助 agent 通过 Composio Rube MCP 运行 API Bible 工作流，采用发现优先的工具选择方式，配合连接检查，并基于当前 schema 更安全地执行。
该技能评分为 66/100，表示可以收录，但能力有限。目录用户可以获得足够的设置与执行模式指导，用于通过 Rube MCP 使用 API Bible；不过相比详细的内置工作流示例，实际使用时应预期更多依赖实时工具发现。
- 技能元数据有效，目标清晰：通过 Composio 的 Rube MCP 自动化 API Bible 操作。
- 包含明确的前置条件和设置步骤，包括连接 Rube MCP、检查 `RUBE_SEARCH_TOOLS`，以及激活 `api_bible` toolkit 连接。
- 强调执行前进行运行时工具发现，有助于 agent 使用当前 schema，而不是猜测工具输入。
- 该仓库仅包含 `SKILL.md`，没有配套文件、脚本、示例或参考资料。
- 工作流指导偏通用，没有展示具体的 API Bible 任务或端到端示例，因此用户可能需要查阅外部 toolkit 文档。
api-bible-automation skill 概览
api-bible-automation 能做什么
api-bible-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行 API Bible 工作流。它的核心价值不是把某个固定的 API Bible 操作写死，而是让 agent 先发现当前的 Composio tool schema，检查 API Bible 连接状态，然后再执行合适的操作，从而减少因工具信息过期导致的错误。
如果你通过 Composio 使用 API Bible，并且希望 agentic workflow 尊重实时工具发现，而不是依赖过时示例，那么 api-bible-automation 会很适合。
最适合的用户与使用场景
api-bible-automation skill 最适合已经在使用支持 MCP 的客户端，并希望用自然语言指令自动化 API Bible 任务的开发者、自动化构建者和 AI 运营人员。典型场景包括查询可用的 API Bible 操作、准备结构化请求、验证连接状态，以及把一个粗略任务转成可通过 Rube MCP 执行的计划。
如果你只需要静态 API 文档、不使用 Composio，或者无法在客户端中连接 Rube MCP，那么它的价值会比较有限。
它和普通 prompt 的区别
普通 prompt 可能会告诉 agent “使用 API Bible”，但 agent 往往会猜测 tool name 和输入字段。api-bible-automation 的关键区别在于它强制采用“先发现再执行”的模式：调用 RUBE_SEARCH_TOOLS，检查当前 schema 和已知风险点，然后在确认连接处于可用状态后，才运行匹配的 API Bible tool。
这很重要，因为 MCP tool schema 可能会变化；如果 agent 按旧参数假设来执行，API Bible 工作流就可能失败。
如何使用 api-bible-automation skill
api-bible-automation 安装上下文
从 Composio skills repository 安装该 skill，例如：
npx skills add ComposioHQ/awesome-claude-skills --skill api-bible-automation
然后在你的客户端中配置 Rube MCP：
https://rube.app/mcp
上游 skill 预期 Rube MCP 会为 api_bible toolkit 暴露 RUBE_SEARCH_TOOLS 以及连接管理能力。在依赖该 skill 之前，请先确认你的客户端能看到 Rube MCP tools，并且 API Bible 连接已通过返回的 Composio 授权流程激活。
你需要提供哪些输入
想获得更稳定的 api-bible-automation usage 效果，不要只告诉 agent “做一个 API Bible 任务”。建议提供：
- 你希望得到的具体 API Bible 结果
- 已知的实体名称、ID、endpoint 或搜索词
- 任务是读取、创建、更新、比较，还是总结信息
- 输出格式，例如 table、JSON、checklist 或 execution log
- 权限边界，尤其是操作可能修改数据时
较弱的 prompt 是：“Use API Bible to find this.”
更好的 prompt 是：“Using api-bible-automation, discover the current API Bible tools, confirm the api_bible connection is active, then search for operations related to authentication headers. Return the tool used, required fields, results summary, and any schema assumptions.”
更可靠的运行流程
建议按这个实用顺序执行：
- 要求 agent 调用
api-bible-automation。 - 针对你的具体 API Bible 使用场景，要求执行一次
RUBE_SEARCH_TOOLS调用。 - 让 agent 在执行前报告发现的 tool slug、必需 schema 和已知风险点。
- 使用 Rube connection tool 检查或创建 toolkit
api_bible的 API Bible 连接。 - 只有在连接状态为
ACTIVE后才执行。 - 要求输出一份简明运行报告，展示使用的输入、收到的输出和可选的后续动作。
这套流程正是使用 api-bible-automation for Workflow Automation 的核心理由：它减少盲目执行，并让工具选择过程可审计。
优先阅读的 repository 文件
repository 路径是 composio-skills/api-bible-automation，最需要检查的主文件是 SKILL.md。从文件树预览来看，没有可见的 helper scripts、rules folders 或 reference files，因此是否安装主要取决于该 skill 的说明，以及你是否能提供可工作的 Rube MCP 环境。
阅读 SKILL.md，了解 prerequisites、setup、tool discovery 和核心 workflow pattern。还应查看链接的 Composio toolkit 文档 composio.dev/toolkits/api_bible，确认 API Bible 相关能力和账号要求。
api-bible-automation skill 常见问题
api-bible-automation 对新手友好吗？
只有在你的客户端已经支持 MCP，并且你能顺利完成 Composio connection flow 时，它才算对新手友好。skill 本身给出了清晰步骤，但它假设用户理解 tool calls、MCP server configuration 和 connection state。如果这些概念还不熟悉，建议先确认 RUBE_SEARCH_TOOLS 能正常工作，再尝试 API Bible 任务。
什么时候不应该使用这个 skill？
当你需要离线查询文档、Rube MCP 不可用，或者你的组织不允许外部 MCP 连接时，不应使用 api-bible-automation。对于高风险写入操作也应谨慎，除非你的 prompt 明确定义了审批步骤，并且 agent 在运行前确认了精确的 tool schema。
它和直接使用 Composio 有什么不同？
直接使用 Composio 会给你 toolkit，而这个 skill 额外提供了一套可重复的 agent 指令模式：发现工具、验证连接、执行并报告。当你把工作委托给 Claude 或其他支持 skill 的 assistant 时，这很有用，因为它能减少 schema 猜测，并让自动化过程更容易复核。
哪些因素会阻碍采用？
主要阻碍包括 MCP 可用性、API Bible 授权未激活、任务描述不清，以及对 tool name 的过时假设。该 skill 明确要求先搜索工具，因此它最适合 agent 可以交互式调用 Rube tools 的环境，而不是只能生成静态说明的环境。
如何改进 api-bible-automation skill
用任务形态改进 api-bible-automation prompt
提升 api-bible-automation 输出质量最快的方法，是在执行前说明任务形态。明确你想要 discovery、retrieval、comparison、validation，还是会改变状态的操作。加入约束，例如“do not create or update anything without confirmation”或“return only fields supported by the discovered schema”。
这能帮助 agent 为 RUBE_SEARCH_TOOLS 选择更合适的搜索查询，避免把错误的 API Bible tool 硬套到任务上。
防范常见失败模式
常见失败包括跳过工具发现、使用猜测的 tool slug、在连接未激活时继续执行，或发送当前 schema 中不存在的字段。可以要求 agent 展示一个 preflight block 来规避这些问题：
- Discovered tool name
- Required parameters
- Optional parameters worth setting
- Connection status
- Planned execution step
- Expected output shape
如果其中任何一项未知，agent 应暂停并提出澄清问题。
首次输出后继续迭代
第一次运行后，不要只说“try again”。给出有针对性的反馈：缺少字段、输出过多、实体错误、引用不足，或操作范围不安全。一个有用的后续 prompt 是：
“Reuse the same Rube session if available, refine the API Bible tool query for authentication-related operations only, and return a smaller table with tool slug, required inputs, and recommended next action.”
这样可以让 api-bible-automation guide 的工作流保持高效，同时继续保留对 schema 的感知。
添加项目级运行规则
团队使用时，可以用本地约定包裹该 skill：允许的 API Bible 操作、写入动作的审批规则、命名标准、日志要求，以及偏好的输出格式。由于上游 skill 只有 SKILL.md，没有额外 policy files，如果可靠性、可审计性或合规性很重要，就应通过你的本地 prompt 或项目说明来承载这些控制规则。