cli-output-review

Review CLI human-readable output for scanability, hierarchy, and terminal compatibility.

4.4k|154|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/fallow-rs/fallow --skill cli-output-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cli-output-review
Source: https://github.com/fallow-rs/fallow/tree/main/.agents/skills/cli-output-review
Command: npx skills add https://github.com/fallow-rs/fallow --skill cli-output-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Changes to a CLI's human-readable output can silently degrade readability, break terminal rendering, or produce confusing empty states. This Skill provides a structured review checklist so output changes in the fallow CLI are evaluated consistently before shipping.

Core Features & Use Cases

  • Output Quality Review: Evaluates information hierarchy, scanability, and progressive disclosure in CLI output.
  • Terminal Compatibility Checks: Verifies NO_COLOR support and terminal compatibility for formatted text.
  • Empty State Validation: Ensures commands produce sensible output when there is nothing to report.
  • Use Case: After modifying a reporter in crates/cli/, run this review to confirm the new output remains scannable, respects NO_COLOR, and ends with a clear APPROVE, CONCERN, or BLOCK verdict.

Quick Start

Review the CLI output changes in crates/cli for scanability, empty states, and NO_COLOR terminal compatibility.

Frequently Asked Questions about cli-output-review

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

FAQPage Schema
How do I review CLI output changes for readability?▼

Read the reviewer guidance in .agents/agents/cli-output-reviewer.md and the rules in .agents/rules/cli-crate.md, then inspect the concrete output path under crates/cli. Evaluate information hierarchy, scanability, and progressive disclosure before issuing a verdict.

What should a CLI output review check for terminal compatibility?▼

Verify NO_COLOR support so output renders correctly when colors are disabled, and confirm formatting works across terminals. The review also covers empty states and progressive disclosure of detail.

When should I run a CLI output review?▼

Run it whenever changes affect human-readable output, command UX, or text formatting in the CLI, including modifications to reporters, snapshots, or related tests under crates/cli.

What verdict does the CLI output review produce?▼

The review ends with one of three explicit verdicts: APPROVE, CONCERN, or BLOCK. This gives a clear, actionable signal on whether the output change is acceptable to ship.

Does the review cover empty command output states?▼

Yes, empty states are an explicit focus area. The review checks that commands produce sensible, well-formatted output even when there is nothing to report.