🎯

mixseek-config-validate

🎯Skill

from drillan/mixseek-plus

VibeIndex|
What it does

Validates MixSeek configuration files (TOML) for syntax correctness and schema compliance, detecting and suggesting fixes for configuration errors.

📦

Part of

drillan/mixseek-plus(10 items)

mixseek-config-validate

Installation

pip installInstall Python package
pip install git+https://github.com/drillan/mixseek-plus
pip installInstall Python package
pip install "git+https://github.com/drillan/mixseek-plus#egg=mixseek-plus[playwright]"
📖 Extracted from docs: drillan/mixseek-plus
1Installs
-
AddedFeb 4, 2026

Skill Details

SKILL.md

MixSeekの設定ファイル(team.toml、orchestrator.toml、evaluator.toml、judgment.toml)を検証します。「設定を検証」「TOMLをチェック」「設定ファイルの確認」「バリデーション」「ワークスペースの検証」といった依頼で使用してください。TOML構文とMixSeekスキーマへの準拠を確認します。

Overview

# MixSeek 設定検証

概要

MixSeek-Coreの設定ファイルがTOML構文およびMixSeekスキーマに準拠しているかを検証します。TOML構文エラー、必須フィールドの欠落、値の範囲外エラーなどを検出し、修正方法を提案します。

前提条件

  • MixSeek-Coreがインストールされていること
  • 検証対象の設定ファイルが存在すること
  • Pythonコマンドが利用可能であること(detect-python-command スキルで判別)

対応ファイルタイプ

| ファイルタイプ | 説明 | パス例 |

|---------------|------|--------|

| team | チーム設定 | configs/agents/team-*.toml |

| orchestrator | オーケストレーター設定 | orchestrator.toml |

| evaluator | 評価設定 | configs/evaluators/evaluator.toml |

| judgment | 判定設定 | configs/judgment/judgment.toml |

使用方法

Step 1: 検証対象の確認

ユーザーにどのファイルを検証するか確認:

```

検証対象のファイルを指定してください:

  • 特定ファイル: configs/agents/team-web-research.toml
  • 全設定: すべての設定ファイル

```

Step 2: 検証の実行

detect-python-command スキルの run-python.sh を使用して検証を実行します:

```bash

# 特定ファイルの検証

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py

# ファイルタイプを指定して検証

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py --type team

```

Step 3: 結果の報告

検証結果をユーザーに報告:

  • 成功時: 検証項目と結果を表示
  • 失敗時: エラー内容と修正方法を提案

検証項目

TOML構文検証

  • 基本構文の正しさ
  • 文字列のクォート
  • 配列・テーブルの形式
  • コメントの形式

スキーマ検証

| 項目 | 説明 |

|------|------|

| 必須フィールド | 必要なフィールドが存在するか |

| フィールド型 | 値の型が正しいか |

| 値の範囲 | 数値が許容範囲内か |

| 形式 | モデル形式など特殊形式の検証 |

| 一意性 | agent_name等の一意性 |

| 整合性 | min_rounds <= max_rounds 等 |

単一ファイルの検証

```

User: team.tomlを検証して

Agent: configs/agents/team-web-research.toml を検証します...

✅ TOML構文: OK

✅ 必須フィールド: OK

- team.team_id: "team-web-research"

- team.team_name: "Web Research Team"

- team.leader.model: "google-gla:gemini-2.5-pro"

✅ モデル形式: OK

✅ Member Agent数: 2/15

✅ agent_name一意性: OK

検証成功: この設定ファイルは有効です。

```

エラーがある場合

```

User: team.tomlを検証して

Agent: configs/agents/team-broken.toml を検証します...

❌ エラーが検出されました:

1. 必須フィールド欠落

- team.members[0].tool_description が未定義

- 修正: tool_description = "エージェントの説明" を追加

2. 値の範囲外

- team.max_concurrent_members = 100 (範囲: 1-50)

- 修正: 1〜50の値に変更

3. モデル形式エラー

- team.leader.model = "gemini-pro" (無効)

- 修正: "google-gla:gemini-2.5-pro" 形式に変更

```

全ファイル検証

```

User: すべての設定ファイルを検証して

Agent: ワークスペース内の設定ファイルを検証します...

configs/agents/team-web-research.toml

✅ 有効

configs/agents/team-analysis.toml

❌ エラー: member[0].agent_type が無効な値 "search"

→ 有効な値: plain, web_search, code_execution, web_fetch, custom

configs/evaluators/evaluator.toml

✅ 有効

configs/judgment/judgment.toml

✅ 有効

orchestrator.toml

✅ 有効

結果: 4/5 ファイルが有効

```

エラーメッセージと修正方法

TOML構文エラー

```

Error: Invalid TOML at line 15

```

原因: TOML構文が無効

修正: 該当行の構文を確認(クォート、ブラケット等)

必須フィールド欠落

```

Error: Missing required field: team.leader.system_instruction

```

修正: 指定されたフィールドを追加

```toml

[team.leader]

system_instruction = "指示内容"

```

型エラー

```

Error: Field 'temperature' must be float, got string

```

修正: 値の型を修正

```toml

# 誤り

temperature = "0.7"

# 正しい

temperature = 0.7

```

範囲エラー

```

Error: Field 'max_rounds' must be 1-10, got 15

```

修正: 値を許容範囲内に変更

モデル形式エラー

```

Error: Invalid model format: "gemini-pro"

Expected format: "provider:model-name"

```

修正: provider:model-name 形式に変更

```toml

# 誤り

model = "gemini-pro"

# 正しい

model = "google-gla:gemini-2.5-pro"

```

重み合計エラー

```

Error: Metric weights must sum to 1.0, got 0.8

```

修正: 重みの合計が1.0になるよう調整

CLIコマンド(直接実行)

```bash

# 単一ファイル検証

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py path/to/config.toml

# タイプ指定

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py config.toml --type team

# JSON出力

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py config.toml --json

# 詳細出力

skills/detect-python-command/scripts/run-python.sh \

skills/mixseek-config-validate/scripts/validate-config.py config.toml --verbose

```

トラブルシューティング

スクリプトが実行できない

```

Error: No module named 'mixseek'

```

解決方法:

  1. MixSeek-Coreがインストールされているか確認
  2. uv sync を実行して依存関係を更新

ファイルが見つからない

```

Error: File not found

```

解決方法:

  1. ファイルパスが正しいか確認
  2. $MIXSEEK_WORKSPACEからの相対パスを使用

参照

  • Pythonコマンド判別: skills/detect-python-command/SKILL.md
  • チーム設定スキーマ: skills/mixseek-team-config/references/TOML-SCHEMA.md
  • オーケストレーター設定スキーマ: skills/mixseek-orchestrator-config/references/TOML-SCHEMA.md
  • 評価設定スキーマ: skills/mixseek-evaluator-config/references/TOML-SCHEMA.md

More from this repository9