safetyculture-automation

safetyculture-automation skill の概要

safetyculture-automation の用途

safetyculture-automation は、Composio の Rube MCP server を通じて SafetyCulture 業務を自動化するための Claude skill です。利用可能な SafetyCulture tools を検出し、認証状態を確認し、古いハードコード済みパラメータに頼らず、現在の Composio tool schemas に基づいてアクションを実行する必要があるエージェント向けに設計されています。

この skill の役割は、「汎用的な SafetyCulture プロンプトを書く」ことではありません。検査の検索、テンプレート管理、SafetyCulture レコードの調整といった業務依頼を、AI エージェントが安全に、schema を意識した Rube MCP ワークフローへつなげられるようにすることです。

向いているユーザーとワークフロー

この skill は、すでに Claude と MCP を使っており、エージェントのワークフロー内で SafetyCulture automation を行いたいチームに適しています。特に、業務運用、安全管理、コンプライアンス、施設管理、フィールドサービスのチームで、SafetyCulture データと繰り返しやり取りする必要があり、実行前にエージェントへ tool の利用可否を確認させたい場合に有用です。

また、Composio toolkits を評価している開発者やビルダーにも向いています。この skill は、Rube MCP に接続し、safetyculture toolkit を有効化し、まず tool を検索してから、返された schema に従って実行する、というパターンを明確に徹底しているためです。

主な差別化ポイント：まず tool discovery を行う

safetyculture-automation skill の最も強い点は、実行前に RUBE_SEARCH_TOOLS を使うことを徹底している点です。これは重要です。Composio の tool 名、必須フィールド、schema は変わる可能性があるためです。通常のプロンプトでは、存在しないパラメータを作り出したり、古い API 形状を前提にしたりすることがあります。この skill は、ワークフローを実行する前に、現在利用可能な SafetyCulture tools、入力 schema、実行計画、注意点を取得するようエージェントに指示します。

導入時に考慮すべきこと

この skill は、リポジトリパス内に SKILL.md だけがあるコンパクトな skill です。そのため、導入の成否は同梱のヘルパースクリプトではなく、あなたの MCP 設定に依存します。クライアントで Rube MCP を利用できる必要があり、RUBE_MANAGE_CONNECTIONS を通じて有効な SafetyCulture 接続も必要です。MCP tools を使えない環境では、この skill だけでは不十分です。

safetyculture-automation skill の使い方

safetyculture-automation のインストール前提

Claude skills をサポートするクライアントで、Composio skills repository から skill をインストールします。

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

次に、クライアントに以下を追加して Rube MCP を設定します。

https://rube.app/mcp

上流の skill では、MCP endpoint に別個の API key は不要とされていますが、有効な SafetyCulture 接続は必要です。実務上は、まず RUBE_SEARCH_TOOLS が利用可能であることを確認し、そのうえで toolkit safetyculture を指定して RUBE_MANAGE_CONNECTIONS を使います。返されたステータスが ACTIVE でない場合は、エージェントに SafetyCulture 操作を実行させる前に、認証リンクで接続を完了してください。

skill に渡すべき入力

safetyculture-automation を効果的に使うには、業務タスク、SafetyCulture のオブジェクト種別、既知の識別子、日付範囲、フィルター、返してほしい内容または変更してほしい内容をエージェントに伝えます。この skill は schemas を検出できますが、あなたの業務上の意図や承認範囲までは推測できません。

弱いプロンプト:

“Update SafetyCulture.”

より強いプロンプト:

“Use safetyculture-automation for Workflow Automation. Search current Rube tools first, then find SafetyCulture inspection records for Site A from the last 30 days. Summarize open corrective actions by priority. Do not modify records unless you show the proposed changes and ask for approval.”

このように書くと、ユースケース、範囲、期間、変更ポリシー、期待する出力形式がエージェントに伝わるため、出力の品質が上がります。

初回実行の実践ワークフロー

まず composio-skills/safetyculture-automation/SKILL.md を読みます。scripts/、references/、rules/ のようなサポートフォルダは見当たらないため、SKILL.md が信頼すべき情報源です。

初回実行では、次の流れが適しています。

1. エージェントに Rube MCP が利用可能か確認させる。
2. RUBE_MANAGE_CONNECTIONS で SafetyCulture 接続状態を確認させる。
3. 具体的なタスクに対して RUBE_SEARCH_TOOLS を呼び出させる。
4. 検出された tool 名、必須フィールド、注意点を確認する。
5. その後にのみ実行を許可する。書き込み系アクションでは、できれば dry-run または確認ステップを入れる。

skill をうまく起動するプロンプトの型

skill 名と、必須の discovery step を明示した直接的な表現を使います。

“Use the safetyculture-automation skill. First call RUBE_SEARCH_TOOLS for this SafetyCulture task and inspect the current schema. Then propose the execution plan before running tools: [your task].”

書き込みが多いワークフローでは、次も追加します。

“Do not create, update, archive, or delete anything until you show the exact tool call inputs and I approve.”

この追加指示により、意図しない変更を減らし、実行前に schema discovery の挙動を確認しやすくなります。

safetyculture-automation skill FAQ

safetyculture-automation は開発者専用ですか？

いいえ。利用している AI クライアントがすでに MCP をサポートしており、誰かが Rube MCP と SafetyCulture 接続を設定済みであれば、非開発者でも使えます。ただし、初期設定には MCP server の設定と接続管理が含まれるため、通常のプロンプトだけで使う場合より技術的です。

通常の SafetyCulture プロンプトより何が優れていますか？

通常のプロンプトでも、やりたいことを説明することはできます。しかし、現在の Composio SafetyCulture tool schema を正確に把握することはできません。safetyculture-automation skill は、まず tools を検索するようエージェントに指示するため、存在しない tool 名、欠落フィールド、古い前提に基づく実行を減らせます。

この skill の範囲はどこまでですか？

この skill には、カスタムスクリプト、テンプレート、SafetyCulture の業務ドメインルールは含まれていません。また、SafetyCulture の権限、アカウントアクセス、業務上の承認を置き換えるものでもありません。エージェントが Rube MCP tools を正しく検出して使えるようにするためのものであり、実際に何ができるかは、接続権限とプロンプト上の制約によって決まります。

使わないほうがよいケースは？

単発のポリシー文書作成、静的なチェックリスト案、tool 実行を伴わない一般的な SafetyCulture 相談だけが必要な場合は使う必要がありません。また、MCP tool calls が無効化されている環境、監査要件によりエージェント経由の変更が認められない環境、SafetyCulture 接続を ACTIVE にできない環境でも避けるべきです。

safetyculture-automation skill を改善する方法

スコープを絞って safetyculture-automation の結果を改善する

最も重要な改善は、エージェントに狭く、監査しやすいタスクを渡すことです。オブジェクト種別、場所、チーム、日付範囲、ステータス、必要な出力を含めます。例:

“Find inspections for Warehouse 3 completed this week, list failed items, group by inspector, and export a concise summary. Search tools first and do not modify anything.”

具体的なスコープを与えることで、tool search が関連性の高い SafetyCulture operations を返しやすくなり、エージェントが無関係なワークフローを探索するのを防げます。

リスクのある操作には承認ゲートを追加する

作成、更新、削除、割り当て、クローズのいずれの操作でも、確認ステップを必須にします。実行前に、検出された tool、必須フィールド、予定している入力、期待される結果をエージェントに提示させてください。これは特に重要です。この skill のリポジトリは意図的に最小構成であり、「まず tools を検索する」というパターン以外の追加ガードレールルールを提供していないためです。

注意すべきよくある失敗

最もよくある失敗は、RUBE_SEARCH_TOOLS を飛ばして schema を推測してしまうことです。その場合はワークフローを止め、具体的なユースケースに基づいて tools を再検出するようエージェントに依頼してください。もう一つの失敗は、SafetyCulture 接続が ACTIVE になる前に実行しようとすることです。プロンプトを調整する前に、RUBE_MANAGE_CONNECTIONS で接続状態を修正してください。

三つ目の問題は、目的が曖昧なことです。“Handle inspections” は広すぎます。“Find incomplete inspections assigned to Team B and summarize blockers” であれば実行可能です。

初回出力のあとに改善を重ねる

初回実行後は、検出された schema と返されたレコードを根拠に改善します。次のようなフォローアップ質問をします。

• “Which required fields were unavailable?”
• “Which SafetyCulture tools matched this use case?”
• “What assumptions did you make before execution?”
• “What would change if this were a write operation?”

これにより、safetyculture-automation は単発のコネクタではなく、管理された workflow automation パターンとして使えるようになります。