skills.rest
cli-agent-spec
cli-agent-specOFFICIAL
Explore all skills by this author →
GitHub

cli-agent-report

Generate perspective-specific reports from CLI evaluation findings.

5|Updated Mar 14, 2026
Search Tags:#report generation#ai agents#failure modes#template rendering#operational guidance#cli evaluation#integration invariants
One-click install
npx skills add https://github.com/cli-agent-spec/cli-agent-spec --skill cli-agent-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cli-agent-report
Source: https://github.com/cli-agent-spec/cli-agent-spec/tree/main/skills/cli-agent-report
Command: npx skills add https://github.com/cli-agent-spec/cli-agent-spec --skill cli-agent-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill converts existing CLI evaluation findings into clear, perspective-specific reports so AI agents and CLI authors can quickly understand what fails and how to fix it.

Core Features & Use Cases

  • Perspective-specific reporting (5 modes): generate reports for developers of CLI frameworks, agent builders, runtime-ready briefings for agents, concrete issues agents will hit, or a full bundled set.
  • Findings-to-actions transformation: summarizes scoped failure modes and produces fix lists mapped to referenced requirements.
  • Operational guidance for invocation: extracts environment/flag invariants and output-handling patterns needed for reliable agent use.
  • Local artifact workflow: consumes evaluation artifacts under evaluations/<cli-name>/ and writes only in the all mode.

Quick Start

Ask the skill to run mode all for the CLI name you evaluated, so it generates the full report bundle (including runtime brief, integration guide, issues report, and an index) from your existing findings.

Frequently Asked Questions about cli-agent-report

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

FAQPage Schema
How do I generate reports from existing CLI evaluation findings?▼

Generate CLI evaluation reports by loading locally stored artifacts under evaluations/<cli-name>/ and applying template-driven rendering to produce perspective-specific briefings, fix lists, and integration invariants.

What is a runtime briefing for AI agents using CLI tools?▼

A runtime briefing is a perspective-specific report that extracts environment and flag invariants alongside output-handling patterns, providing AI agents with the operational guidance needed for reliable CLI invocation.

How do I extract integration invariants from CLI failure modes?▼

Extract integration invariants by selectively loading challenge sections from stored evaluation artifacts and transforming discovered workarounds into structured tables for agent operational guidance.

Can I scope CLI failure mode reports by severity and section identifiers?▼

Yes, the CLI report generation supports optional scoping by severity and section identifiers, allowing you to selectively filter failure modes and produce targeted fix lists mapped to referenced requirements.

What is the best way to bundle agent-ready reports for a evaluated CLI?▼

Run the all mode to generate the full report bundle, which writes a comprehensive set including the runtime brief, integration guide, issues report, and an index from your existing evaluation findings.

Does CLI report generation validate contract correctness for AI agent integration?▼

Yes, the template rendering process validates the final report bundle for contract correctness, ensuring that the generated runtime briefings and fix lists meet deterministic aggregation requirements.

Related Skills

Explore More Software Engineering Skills→
futureteafuturetea

openspec-ff-change

Generate OpenSpec change artifacts from a change name or description.

Community
Intermediate
tylerjrbuelltylerjrbuell
21

quality-assurance

Verify LLM outputs with hallucination detection and semantic entropy thresholds.

Community
Advanced
AlekseiULAlekseiUL
16

minimax-docx

Create and edit DOCX documents using deterministic OpenXML pipelines with validation.

Community
Advanced
randrand
126

discover-cicd

Discover CI/CD and automation skills during GitHub Actions and GitLab CI tasks.

Community
Basic