breezy-hr-automation

breezy-hr-automation skill の概要

breezy-hr-automation でできること

breezy-hr-automation は、Composio の Rube MCP server を通じて Breezy HR の採用オペレーションを実行するための Claude skill です。Breezy HR API の呼び出しを固定的に書き込むのではなく、まず RUBE_SEARCH_TOOLS で現在利用できる Breezy HR ツールを検出し、アカウント接続を確認したうえで、返されたスキーマに沿って選択したワークフローを実行するようエージェントに指示します。

MCP のツール名、必須フィールド、実行プランは変わる可能性があります。そのため、この skill の主な価値は、固定コマンドを大量に持つことではありません。Breezy HR automation をより安全に進めるために、「実行前に必ず検出する」という運用パターンを提供する点にあります。

採用チームやオペレーション担当者に向いているケース

breezy-hr-automation skill は、すでに Breezy HR を使っていて、候補者の検索、パイプライン更新の調整、求人や応募者データの取得、再利用可能な採用ワークフローの準備といった構造化されたタスクを AI アシスタントに手伝わせたい採用担当者、採用コーディネーター、Talent Operations チーム、創業者に適しています。

特に、採用タスクを明確に説明でき、Rube MCP 経由で対象の Breezy HR ワークスペースへ接続する権限がある場合に有用です。

汎用プロンプトとの違い

通常のプロンプトでも Breezy HR のタスクを説明することはできますが、現在利用可能な MCP ツールや、それぞれに必要なフィールドを自動的に把握できるわけではありません。この skill は、まずツールを確認するワークフローを追加します。利用可能な Breezy HR 操作を検索し、接続を確認し、スキーマを調べ、その後で初めて実行します。

そのため、古い前提によって呼び出しが失敗したり、必須フィールドが不足したり、意図しない更新が起きたりしやすい採用オペレーションでは、より安全に使えます。

導入要件と制約

インストール前に、利用している AI クライアントが MCP をサポートしており、https://rube.app/mcp をサーバーとして追加できることを確認してください。また、breezy_hr toolkit を使い、RUBE_MANAGE_CONNECTIONS 経由で Breezy HR への有効な接続を作成する必要があります。

この skill のリポジトリは意図的にコンパクトです。主要ファイルは SKILL.md で、同梱スクリプトや参照フォルダはありません。完成済みの採用自動化アプリケーションではなく、実行プロトコルとして扱ってください。

breezy-hr-automation skill の使い方

breezy-hr-automation のインストールとセットアップ手順

Composio skills repository から skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill breezy-hr-automation

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

https://rube.app/mcp

MCP が利用可能になったら、RUBE_SEARCH_TOOLS が応答することを確認します。その後、RUBE_MANAGE_CONNECTIONS または利用可能な Rube の接続管理ツールを使って、breezy_hr toolkit を接続します。接続ステータスが ACTIVE になるまでは、エージェントに Breezy HR の操作を実行させないでください。

すべてのワークフローはツール検出から始める

最も重要な利用ルールは、最初にツールを検索することです。最初の呼び出しは、実行したい採用オペレーションを具体的に表す形が適しています。

RUBE_SEARCH_TOOLS with a use case such as "Find candidates in Breezy HR for a specific job and summarize their current pipeline stage"

返された結果をもとに、その後のワークフローを組み立てます。利用可能な tool slug、入力スキーマ、必要な ID、推奨プラン、注意点が含まれるはずです。このステップにより、エージェントがフィールド名を推測したり、古いツール前提で実行したりするリスクを避けられます。

曖昧な目的を実行可能なプロンプトに変える

弱いプロンプト:

“Update Breezy HR candidates.”

より良いプロンプト:

“Use the breezy-hr-automation skill. First search Rube tools for the current Breezy HR schema. Confirm the Breezy HR connection is active. Then find candidates for the Customer Support Specialist role, identify candidates in the Phone Screen stage, and prepare a proposed stage-update plan. Do not make changes until I approve the candidate list and target stage.”

このように書くと、タスク、必要な安全確認、対象オブジェクト、選定条件、承認の境界がエージェントに伝わります。採用業務では、求人タイトルまたは ID、候補者の識別子、実行したい操作、更新を許可するかどうか、書き込み操作の前にどの確認が必要かを含めてください。

skill を信頼して使う前に読むべきファイル

まず composio-skills/breezy-hr-automation/SKILL.md を読んでください。中核となる前提条件、セットアップの流れ、検出呼び出しのパターン、実行時の期待動作が記載されています。

現在の skill フォルダには、追加の scripts/、references/、resources/、README.md ファイルはありません。そのため、事前に作り込まれた候補者処理ロジックがあるとは考えないでください。実際の動作は、skill の指示と Rube MCP によるライブのツール検出を組み合わせることで成立します。

breezy-hr-automation skill FAQ

breezy-hr-automation は採用担当者専用ですか？

Recruiting ワークフロー向けに設計されていますが、利用者は Breezy HR の運用に責任を持つ人であれば構いません。Talent ops、HR 管理者、Hiring managers、agency recruiters、スタートアップのオペレーション担当者などが該当します。重要なのは、Breezy HR ワークスペースへのアクセス権があり、タスクを安全に指定できるだけの文脈を持っていることです。

Breezy HR の更新を自動化できますか？

はい。Rube Breezy HR toolkit が必要な操作を公開しており、接続に権限があれば可能です。ただし、読み取り、計画、書き込みのステップは分けてください。候補者、求人、メモ、パイプラインステージを更新する場合は、変更を実行する前にプレビューを作成し、承認を待つようエージェントに依頼するのが安全です。

なぜ最初にツール検索が必要なのですか？

この skill は固定コマンドではなく、ライブの MCP ツールスキーマに依存しています。RUBE_SEARCH_TOOLS によって、現在利用できる Breezy HR 操作と、その呼び出し方をエージェントが把握できます。検出を省くと、実行失敗、必須フィールドの不足、toolkit に関する誤った前提のリスクが高まります。

この skill を使わないほうがよい場面は？

サポートされていない Breezy HR 操作、不明確な一括更新、人による確認なしのセンシティブな採用判断、候補者本人や意図した操作を確認できないワークフローには breezy-hr-automation を使わないでください。また、利用中のクライアントが MCP を使えない場合や、Breezy HR 接続を有効化できない場合にも適していません。

breezy-hr-automation skill を改善する方法

breezy-hr-automation への入力を改善する

入力が具体的なほど、採用業務の出力は安全になります。職種名または ID、候補者名または ID、パイプラインステージ、日付範囲、希望する出力形式、エージェントが Breezy HR に書き戻してよいかどうかを指定してください。

たとえば、“summarize candidates added this week for Job X, grouped by stage, with no updates” は、“check applicants” よりはるかに安全です。変更が必要な場合は、確認ポリシーを明記します。“draft the changes first; execute only after approval.” のように、まず変更案を出し、承認後にのみ実行することを指定してください。

よくある失敗パターンを避ける

最も多い失敗は、エージェントがツールを検出し、接続を確認する前に操作を依頼してしまうことです。もうひとつは、候補者検索、ステージ変更、メモ作成、フォローアップ送信など、複数の目的を監督なしの 1 ステップに詰め込みすぎることです。

ワークフローは、ツール検出、接続確認、データ取得、計画レビュー、承認済み操作の実行、という順番に分けてください。

最初の結果をもとに反復する

最初の出力が返ってきたら、どのツールスキーマを使ったのか、どの必須フィールドを指定したのか、どの前提がまだ残っているのかをエージェントに示させます。候補者や求人に関するワークフローでは、変更を承認する前に、名前、ID、ステージラベルを確認してください。

結果が広すぎる場合は、求人、部門、勤務地、ステータス、日付、パイプラインステージで絞り込みます。内容が浅い場合は、検出済みスキーマで利用できる追加の Breezy HR フィールドを使って、もう一度深掘りするよう依頼してください。

skill を責任を持って拡張する

チームで同じ採用ワークフローを繰り返し実行する場合は、ローカルのプロンプト例や、承認、監査メモ、一括更新の上限に関する社内運用ルールを追加することを検討してください。ただし、元の breezy-hr-automation のパターンは維持してください。つまり、まず現在のツールを検出し、Breezy HR 接続を確認し、明確な入力とレビュー境界がある場合にのみ実行する、という流れです。