name: agent-evaluator description: Deterministic custom subagent selection helper. Use when you need a reproducible, auditable decision on which custom subagents to activate for a user query (runs scripts/agent_evaluator.py).

Agent Evaluator

Evaluate a user query against the workspace's available subagents and return a JSON decision payload (activated/required/suggested agents and scoring).

Mechanism

Run the evaluator script (located in scripts folder relative this skill file) with the user query as an argument.:

shell

python scripts/agent_evaluator.py "YOUR_QUERY_HERE"

Optional: include a contextual file path as the second argument:

shell

python scripts/agent_evaluator.py "YOUR_QUERY_HERE" "path/to/file.ext"

Output

•Writes a JSON object to stdout.
•
Key fields include:
- •activated_agents
- •required_agents
- •suggested_agents
- •evaluations (per-agent score + reasoning)

Examples

Evaluate a query:

shell

python scripts/agent_evaluator.py "Please help refine our custom instruction file"

Evaluate a query with file context:

shell

python scripts/agent_evaluator.py "Update this instruction" "instructions/agent-forced-eval.instructions.md"