AIコーディングエージェントと統合する
k-IDは、k-IDがサポートするすべての法域要件に対して、AIコーディングエージェントにk-IDを正しく統合する方法を教える、小さく組み合わせ可能な公式のAgent Skillsバンドルを公開しています。COPPA（米国）、GDPR-Kids（EU）、英国AADC、英国オンライン安全法（Online Safety Act）、ブラジル ECA Digital、オーストラリアのオンライン安全法 / ソーシャルメディア最低年齢など、地域ごとの要件をカバーします。Claude Code、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLIをはじめ、オープンなAgent Skills仕様に準拠する35以上のAIツールで動作します。
スキルは github.com/kidentify/skills にあります。
2つの統合シェイプ
スキルはk-IDの2つの統合シェイプの両方に対応します。ルーターはユーザーの要求から該当するシェイプを検出し、そのシェイプに必要なスキルのみをロードします。
- シェイプA — フルセッション統合。年齢ゲート → セッション →（同意 | 年齢確認 | しきい値）→ 権限。永続的なユーザーごとの状態と複数のゲート機能を持つゲーム、ソーシャルプラットフォーム、マルチ機能アプリ向け。5〜7個のスキルを使用します。
- シェイプB — スタンドアロンAgeKit+。
/age-verification/perform-access-age-verificationへの1回の呼び出し、ユーザーが年齢確認を完了するためのiframe、そしてwebhookまたはポーリングによる結果取得。年齢ゲートなし、セッションなし、権限なし。18+サイト（英国OSA）、年齢制限付きダウンロード、オーストラリアのソーシャルメディア最低年齢チェック、または単一の年齢証明決定向け。2〜3個のスキルを使用します。
カスタム統合における2つのUIアプローチ
シェイプAでは、k-IDは年齢ゲートと親の同意フローのレンダリング方法を2通り提供しており、スキルはその両方をカバーします。正規の比較は統合方式の選択を参照してください。要点は次のとおりです。
- カスタムUXワークフロー（デフォルト） — 自社で年齢ゲートと同意UIを構築し、
/age-gate/check、/challenge/send-emailなどを直接呼び出します。見た目の完成度とブランドとの統合度が最も高く、iframeを使わずインラインでレンダリングされ、k-IDが対応するすべてのプラットフォーム（Web、Unity WebGL、ゲーム機、ネイティブデスクトップ）で動作します。本番統合では推奨のアプローチです。 - ウィジェット（軽量フォールバック） — 年齢ゲート、エンドツーエンドフロー（年齢ゲート + 親の同意 + データ通知 + 権限 + 保護者設定）、権限管理、データ通知用の、k-IDが提供する組み込み済みiframe。法域に応じた年齢収集を行い、親の同意チャレンジを自動で開始します。統合を小さく・シンプルに・できるだけ速く構築する必要がある場合（PoC、社内ツール、初期段階のゲームなど）に選択してください。
k-id-age-gateとk-id-consent-and-challengesの両スキルは、カスタム経路（パターンA）とウィジェット経路（パターンB）の両方を説明します。エージェントにやりたいことを伝えれば、適切な方を選びます。
スキルが提供するもの
連携して動作する、目的が絞られた8つのスキル：
| スキル | エージェントに教える内容 | シェイプ |
|---|---|---|
k-id-integration | ルーター — シェイプを検出し、適切な兄弟スキルを選択 | 両方 |
k-id-age-gate | フルカスタムのスライダーで/age-gate/checkを呼ぶ方式（パターンA — デフォルト、見た目とブランド統合が最良）、またはk-IDの年齢ゲートウィジェット（パターンB — 小さく・シンプルに・速く統合する場合の軽量フォールバック）で年齢ゲートを構築 — シェイプAのエントリーポイント | A |
k-id-consent-and-challenges | 未成年者向けのGUARDIAN管理の親の同意 — QR + OTP + メール + 直接リンクのカスタム同意画面と、モーダル外のアプリ最上位で行うポーリング（パターンA — デフォルト）、またはエンドツーエンド/権限管理ウィジェット（パターンB — 軽量フォールバック） | A |
k-id-age-verification | 年齢確認および年齢保証 — スタンドアロンAgeKit+（パターン1）、セッション内の未確認アダルト（パターン2）、パーミッションごとのverifiedAgeThresholdフロー（パターン3、英国OSA 18+、ブラジルECA Digital、オーストラリアのソーシャルメディア最低年齢など） | 両方 |
k-id-sessions-and-permissions | セッション処理、パーミッションでゲートされるUIコントロール、/session/upgrade の形、verifiedAgeThresholdの処理 | A |
k-id-webhooks | 生のボディに対するHMAC-SHA256署名検証、冪等性、イベントハンドラ | 両方 |
k-id-server-trust-boundary | APIキーの配置、サーバプロキシ、プリフライトチェック | 両方 |
k-id-mobile-native | iOS / Android / Unityのプラットフォーム年齢シグナルとアプリ内ブラウズ | A（通常） |
エージェントがk-id-integrationをアクティブ化すると、ユーザーのタスクを読み取り、機能スキルと横断的スキルの正しい組み合わせを引き込みます — 個別にインストールする必要はありません。
インストール前に
- Compliance StudioでAPIキーとwebhookシークレットを含むプロダクトが必要です。API認証ガイドを参照してください。
- スキルはこのドキュメントサイトのAPI形式を参照します。AIエージェントの外向き通信を遮断している場合は
docs.k-id.comを許可してください。
ツール別インストール
以下のどのインストール経路でも、同じ8つのスキルがエージェントのコンテキストに入ります。お使いのツールに合う行を選んでください。
Claude Code（最速）
Claude Code内で次を実行：
/plugin marketplace add github.com/kidentify/skills
/plugin install k-id-skills@kidentify
このプラグインは8つのスキルを一度に登録します。/plugin listで確認してください。マーケットプレイスは git形式（github.com/... または https://github.com/...）で追加してください。plugins[].source のスキーマエラーが出る場合は、スキルリポジトリの .claude-plugin/marketplace.json で各プラグインの source が ./ で始まる相対パスになっているか確認してください（Claude Code プラグイン marketplaces）。
Cursor
リポジトリの skills/ をプロジェクトの .agents/skills/（または .cursor/skills/）に置きます。プロジェクトスキルはこれらのパスから自動検出され、ユーザー全体なら ~/.agents/skills/ または ~/.cursor/skills/ です。Cursor Agent Skills を参照してください。
mkdir -p .agents/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* .agents/skills/
rm -rf /tmp/k-id-skills
Cursorを再読み込みし、チャットを開いてスキルがエージェントで利用可能になったことを確認してください。多くの場合、Cursorは再起動なしで新しいスキルを検出します。
OpenAI Codex / Codex CLI
Codexは作業ディレクトリからリポジトリルートまでの .agents/skills/ と、ユーザー全体の ~/.agents/skills/ からスキルを検出します（OpenAI の Codex CLI / IDE 拡張の公式ドキュメント）。~/.codex/skills/ は後方互換で読まれる場合がありますが、主な場所ではありません。プロジェクトは上記の Cursor と同じ手順。グローバルは次のとおりです。
mkdir -p ~/.agents/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* ~/.agents/skills/
rm -rf /tmp/k-id-skills
Codex Agent Skills を参照してください。
GitHub Copilot / Visual Studio Code
Visual Studio Code 上の GitHub Copilot は、プロジェクトスキルを .github/skills/、.claude/skills/、または .agents/skills/ から読み込みます（Visual Studio Code での Agent Skills の使用）。個人スキルは ~/.copilot/skills/、~/.claude/skills/、または ~/.agents/skills/ です。リポジトリの skills/ を好みのパスにコピーしてください。GitHub の手順と揃えるなら .github/skills/ が無難です。
mkdir -p .github/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* .github/skills/
rm -rf /tmp/k-id-skills
Chat で /skills し、表示を確認してください。別ルートを使う場合は chat.agentSkillsLocations で追加できます。
Gemini CLI
Gemini CLI は ユーザースキルを ~/.gemini/skills/ または ~/.agents/skills/ に、ワークスペーススキルを .gemini/skills/ または .agents/skills/ に置きます（同一階層では .agents/skills/ が優先されます）。Gemini CLI Agent Skills を参照。グローバル例：
mkdir -p ~/.gemini/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* ~/.gemini/skills/
rm -rf /tmp/k-id-skills
チーム共有のリポジトリ内インストールは Cursor と同様に .agents/skills/ または .gemini/skills/ に置けます。gemini skills install https://github.com/kidentify/skills.git も利用できます（CLI のスキル管理を参照）。
その他のツールとエアギャップ環境
Agent Skills仕様に準拠するAIエージェントであれば、これらのスキルを利用できます。Agent Skillsクライアントショーケースには35以上の互換ツールが掲載されています。各ツールはスキルの読み込みパスを文書化しています — ディレクトリが分かれば、コピーのレシピは同じです。
外向き接続がブロックされている場合は、GitHubの緑色の「Code」ボタンからZIPをダウンロードし、環境に転送してskills/ディレクトリをエージェント向けのツールスキルパスに展開してください。
これらのインストール経路は、Cursor、OpenAI Codex、Visual Studio Code 上の GitHub Copilot、Gemini CLI の各ドキュメントと照合しました（2026年5月15日時点）。パスが変わった場合は各プロダクトのドキュメントと Agent Skillsクライアントショーケース を参照してください。
スキルの使い方
インストール後は、自然言語でエージェントにタスクを説明するだけです：
- "Next.jsアプリにk-IDを統合して"
- "QR、OTP、メールで親の同意画面を追加して"
- "Compliance StudioのTestイベントに対してwebhookハンドラを検証して"
- "iOSで宣言された年齢範囲を年齢ゲートの前に読み取って"
ルータースキル（k-id-integration）が最初にアクティブ化され、要求を読み取り、適切な専門スキルに引き継ぎます。スキル名を覚える必要はありません。
スキルがエンコードするパターンについてより深く知りたい場合は、関連するコンセプトページを参照してください：
スキル設計の原則
- ドキュメント優先: APIのリクエスト／レスポンス形式はこのドキュメントサイトから取得します。スキルは統合パターンと既知の落とし穴のみをエンコードしているため、k-ID側で形式が変わってもスキルは古くなりません。
- 不変条件をインラインに: 各
SKILL.mdには、実際に発生したバグを防ぐルールを「Gotchas」セクションとしてインラインで含めており、それぞれに一行の「なぜ」を添えています。 - 必要な部分だけを厳密に指定: 壊れやすい操作（APIのボディ形式、署名検証）は正確に指定。UIの調整やフレームワークの選択はあなたに任せます。
- 最後に検証: すべての機能スキルは検証チェックリストで終わり、エージェントが完了を宣言する前に統合が実際に動作していることを確認します。
関連
- Agent Skills仕様
- Agent Skillsクライアントショーケース — 35以上の互換AIツール
github.com/kidentify/skills— リポジトリ- API認証
- テストガイド