SKILL.mdファイルとCobrainerエコシステム

SKILL.mdファイルとは

SKILL.mdファイルは、特定のタスクまたは capability のステップバイステップ指示を定義する構造化Markdownドキュメントです。AI Agentがタスク実行前に読む運用プレイブックです。

詳細な作業指示書と考えてください — ただし人間ではなくAI Agent向けに書かれています。Agentに伝えます：タスクとは何か、いつトリガーするか、どのステップを踏むか、どのツールを使うか、成功基準は何か、エッジケースをどう処理するか。

SKILL.mdファイルは人間の知識とAgent実行をつなぐ橋です。組織の専門知識をAIシステムが消費し実行できる形式でエンコードします。

SKILL.mdファイルの構造

良く構造化されたSKILL.mdファイルには以下のセクションが含まれます：

SKILL.mdファイルのベストプラクティス

1タスク、1ファイル

各SKILL.mdファイルは正確に1つの離散タスクをカバーします。ロールではありません。プロセスではありません。タスクです。

「シニアリクルーター」のようなロールには15〜20のタスクが含まれる場合があります。各タスクに独自のSKILL.mdファイル：「候補者スクリーニング」「要件書ドラフト」「リファレンスチェック実施」「オファーレター生成」。ロールは複合体。タスクは原子的です。

明確なトリガー条件

Agentはいつスキルを使うか知る必要があります。曖昧なトリガー（「必要なとき」）は誤用につながります。具体的なトリガー（「採用マネージャーが10人以上の応募者を持つ空き要件書のスクリーニングリクエストを提出したとき」）は信頼性の高い実行につながります。

測定可能な成功基準

すべてのSKILL.mdファイルで「完了」の定義を指定します。「候補者がスクリーニングされた」ではなく「上位N人の候補者のランク付きshortlistが、各候補者にスキルマッチスコアと記述理由付きで生成され、ATSにスクリーニングレポートとして保存された」。

バージョン管理とオーナーシップ

SKILL.mdファイルは生きているドキュメントです。バージョン管理（誰が何をいつ変更したか）、オーナーシップ（ファイル保守の責任者）、レビューサイクル（指示はまだ正確か）が必要です。

相互参照

タスクは孤立して存在することは稀です。「候補者スクリーニング」SKILL.mdは「要件書ドラフト」SKILL.md（スクリーニングは明確に定義された要件書に依存するため）と「Shortlistレポート生成」SKILL.md（スクリーニングはレポーティングにつながるため）を参照すべきです。

課題：散在しガバナンスされていないSKILL.mdファイル

今日、テックに精通した従業員は各自が独自のAI Agent環境を構築しています。マシン上にフォルダを作成し、個別プロジェクトを持っています。一部はオーケストレーションツールをセットアップ。多くが独自のSKILL.mdファイルを書いています — アドホックで、文書化されず、一貫性がありません。

結果：

• 一貫性なし — 同じタスクがチーム間で異なる記述
• ガバナンスなし — Agentが従う指示を誰もレビュー・承認しない
• 再利用なし — 各自が車輪の再発明
• セキュリティなし — SKILL.mdファイルが適切な承認なしにシステムアクセスをAgentに指示する可能性
• 整合性なし — 個別のSKILL.mdファイルが組織の実際のロール定義、スキル要件、コンプライアンスルールを反映していない

これは組織が20年前に職務記述書で直面した同じ問題です：各マネージャーが独自の形式と基準で職務記述書を書いていました。Job Architectureがそれを解決しました。SKILL.mdガバナンスにも同じ解決策が必要です。

Cobrainerの役割：SKILL.md管理エコシステム

Cobrainerはこの問題を解決するユニークな立場にあります — Cobrainerはすでにすべてのジョブロールをタスクに分解し、すべてのタスクをスキルにマッピングしているためです。SKILL.mdファイルは本質的にジョブロールのタスクを表します。接続は直接的です。

生成：Job ArchitectureからSKILL.mdファイルへ

フロー：

1. Job Architectureがファミリー、クラスター、ロール、レベルを定義
2. 各ロールにタスクリストを含む
3. 各タスクがスキルとプロフィシエンシーレベルにマッピング
4. Cobrainerが各タスク向けにSKILL.mdファイルを生成 — ステップ、ツール要件、成功基準、エッジケースを完全に含む

SKILL.mdファイルはアーキテクチャから導出されます。個人が発明するのではなく、組織構造から計算されます。

調和：1タスク、1 SKILL.md、どこでも

同じタスクが複数のロールに出現します。「ステークホルダーインタビュー実施」はビジネスアナリスト、プロダクトマネージャー、UXリサーチャーロールに存在します。調和がなければ、各チームが同じタスクに対して異なるSKILL.mdを書きます。

Cobrainerは調和します：タスクあたり1つの正規SKILL.md。タスクが5つのロールに出現する場合、5つすべてが同じファイルを参照します。変種（異なるツール、異なるコンテキスト）は別ファイルではなくパラメータで処理します。

集中リポジトリ：ノートPCではなくガバナンス済みライブラリ

個別マシンやフォルダに散在するSKILL.mdファイルの代わりに：

• 集中ストレージ — すべてのSKILL.mdファイルが1つのガバナンス済みリポジトリに存在
• バージョン管理 — すべての変更を追跡、完全なdiff履歴、ロールバック capability
• アクセス制御 — 誰がSKILL.mdファイルを読み、変更し、デプロイできるか
• 配布 — Agentは集中ソースから最新のSKILL.mdを取得。古いローカルコピーなし。

構造から導出：アーキテクチャ変更時、SKILL.mdファイルが更新

ロールが変更されると — 新規タスク追加、スキル更新、プロフィシエンシー目標調整 — そのロールから導出されたSKILL.mdファイルが自動更新されます。アーキテクチャが単一の信頼できるソースです。SKILL.mdファイルは下流アーティファクトです。

一貫したガバナンスルール

Cobrainerが生成するすべてのSKILL.mdファイルは組織ルールを継承します：

• セキュリティルール — Agentがアクセスできるシステム、読み書きできるデータ
• 倫理ルール — 公平性制約、バイアスチェック、人間参加要件
• ブランドの性格 — トーン、コミュニケーションスタイル、言語ルール
• データソース — Agentが情報を取得する場所（承認済みMCPサーバーのみ）
• コンプライアンス制約 — GDPR、報酬透明性、労働法要件

これらのルールは個別ファイルに埋め込まれていません — 組織ポリシーから一貫して、すべての生成SKILL.mdファイルに適用されます。

SKILL.mdファイルが橋渡しする2つの世界

SKILL.mdファイルは2つの世界をつなぎます：

SKILL.mdファイルは翻訳レイヤーです。組織が定義するもの（Job Architecture内）を受け取り、Agentが実行するもの（運用ワークフロー内）に変換します。

Cobrainerは両側 — およびその間の翻訳 — を管理します。これがSKILL.mdファイルの管理エコシステムとして位置づける理由です：単なるジェネレーターではなく、Agent運用を組織デザインに整合させるガバナンス、バージョニング、配布、同期レイヤーです。