cli-agent-evaluate-batch

Evaluate CLI tools against CLI Agent Spec failure modes and produce scored batch reports.

5|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/cli-agent-spec/cli-agent-spec --skill cli-agent-evaluate-batch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-agent-evaluate-batch
Source: https://github.com/cli-agent-spec/cli-agent-spec/tree/main/skills/cli-agent-evaluate-batch
Command: npx skills add https://github.com/cli-agent-spec/cli-agent-spec --skill cli-agent-evaluate-batch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents AI agents from silently hanging, corrupting output, or misinterpreting CLI behavior by running a comprehensive, resumable evaluation across many CLI Agent Spec failure modes.

Core Features & Use Cases

  • Batch evaluation in one run: Tests a CLI tool against multiple §N failure modes with a severity, part, or explicit §N scope.
  • Resumable findings and trace: Loads prior environment and evaluation artifacts, skips fully completed checks, and saves progress incrementally after each failure mode.
  • Scorecard-ready results: Produces a per-failure-mode output plus a final scorecard table summarizing critical/high/medium outcomes.

Quick Start

Run the skill to evaluate your target CLI across all selected §N failure modes, then review the generated findings, trace, issues, and final scorecard for remediation.

Frequently Asked Questions about cli-agent-evaluate-batch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch test CLI tools for AI agent failure modes?

You can batch test CLI tools for AI agent failure modes by running a comprehensive evaluation across multiple CLI Agent Spec failure modes. The skill executes deterministic invocations and produces a scored batch report with critical, high, and medium severity outcomes for remediation.

What is a CLI agent evaluation scorecard?

A CLI agent evaluation scorecard is a final summary table produced after testing a CLI against various failure modes. It aggregates per-failure-mode outcomes across critical, high, and medium severity tiers to help developers identify and fix observability and regression issues.

Can I resume a CLI evaluation if the batch testing process is interrupted?

Yes, you can resume an interrupted CLI evaluation because the skill manages a resumable queue using findings and trace completeness. It loads prior environment artifacts, skips fully completed checks, and saves progress incrementally after each failure mode evaluation.

How are timeouts handled during AI agent CLI batch testing?

Timeouts during AI agent CLI batch testing are recorded as indeterminate scores, marked as ?/3 in the evaluation results. This ensures that unresponsive CLI invocations do not corrupt the final scorecard and are explicitly tracked for further investigation.

Do I need to run environment discovery before evaluating a CLI for AI agents?

Environment discovery is required before evaluating a CLI for AI agents when needed, specifically via the cli-agent-onboard workflow. This setup ensures the skill can perform deterministic invocations per the stored profile during the subsequent batch testing process.

What types of CLI operations are covered by AI agent failure mode testing?

AI agent failure mode testing covers CLIs invoked for deployment, querying, file operations, and pipelines. The evaluation applies across various spec parts and severity tiers to ensure AI agents do not silently hang or misinterpret CLI behavior during these operations.