スキル構成

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

​

フィールド

• allowBundled: バンドル スキルのみのオプションの許可リスト。設定した場合のみ、 リスト内のバンドルされたスキルが対象となります (管理/ワークスペース スキルは影響を受けません)。
• load.extraDirs: スキャンする追加のスキル ディレクトリ (最も低い優先順位)。
• load.watch: スキル フォルダーを監視し、スキル スナップショットを更新します (デフォルト: true)。
• load.watchDebounceMs: スキル ウォッチャー イベントのデバウンス (ミリ秒単位) (デフォルト: 250)。
• install.preferBrew: 利用可能な場合は brew インストーラーを優先します (デフォルト: true)。
• install.nodeManager: ノード インストーラーの設定 (npm | pnpm | yarn | bun、デフォルト: npm)。 これは スキルのインストールにのみ影響します。ゲートウェイ ランタイムは依然として Node である必要があります (WhatsApp/Telegram には推奨されません)。
• entries.<skillKey>: スキルごとのオーバーライド。

• enabled: スキルがバンドル/インストールされている場合でもスキルを無効にするには、false を設定します。
• env: エージェントの実行のために挿入された環境変数 (まだ設定されていない場合のみ)。
• apiKey: プライマリ環境変数を宣言するスキルのオプションの利便性。 プレーンテキスト文字列または SecretRef オブジェクト ({ source, provider, id }) をサポートします。

​

注意事項- entries の下のキーは、デフォルトでスキル名にマップされます。スキルが定義する場合

• ウォッチャーが有効になっている場合、スキルへの変更は次のエージェントのターンに反映されます。

​

サンドボックス化されたスキル + 環境変数

• agents.defaults.sandbox.docker.env (またはエージェントごとの agents.list[].sandbox.docker.env)
• カスタム サンドボックス イメージに環境をベイク処理します