What libraries does this skill support?

This skill is optimized for Node.js CLI tools specifically using Commander.js for command parsing, @clack/prompts for interactivity, and picocolors for terminal styling.

Why is signal handling a critical requirement in this skill?

Proper SIGINT (Ctrl+C) handling is essential for CLI tools to ensure they exit cleanly and return the correct status codes to the shell, preventing resource leaks or hung processes.

Does this skill help with CLI testing?

Yes, it includes a testing adequacy checklist that covers mocking prompts, verifying exit codes, and testing happy/unhappy paths for commands.

What are 'magic numbers' in the context of CLI exit codes?

Magic numbers are hardcoded integers in process.exit() calls. This skill enforces the use of named constants (like EXIT_CODES.CANCELLED) to make scripts more maintainable and predictable.

CLI Review Patterns

Name: CLI Review Patterns
Author: agents-inc

byagents-inc

0•

协作工具

Standardizes the auditing of command-line applications to ensure robust signal handling, clear user feedback, and consistent exit codes.

This skill provides a comprehensive framework for auditing CLI tools built with popular Node.js libraries like Commander.js and @clack/prompts. It focuses on the unique challenges of terminal-based software, including proper signal handling (SIGINT), graceful cancellation of interactive prompts, configuration hierarchy, and the quality of help documentation. By implementing these patterns, developers ensure their CLI applications are reliable, testable, and provide a superior user experience through actionable error messages and visual progress indicators.

主要功能

01Validates named exit code constants to replace brittle magic numbers

02Verifies SIGINT and signal handling for graceful terminal exits

03Ensures interactive prompts handle user cancellation correctly with p.isCancel()

04Audits CLI user experience including progress spinners and help documentation

05Checks configuration precedence across flags, environment variables, and config files

060 GitHub stars

使用场景

01Automating Pull Request reviews for Node.js-based command-line utilities

02Auditing legacy CLI code to improve error handling and user feedback

03Ensuring architectural consistency across a suite of internal developer tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agents-inc/skills meta-reviewing-cli-reviewing

For use in Claude.ai and ChatGPT

Download Skill