cli-guidelines

Provides CLI design principles and best practices for software developers.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/takuto-tanaka-4digit/excel-unidiff-cli --skill cli-guidelines-takuto-tanaka-4digit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-guidelines
Source: https://github.com/takuto-tanaka-4digit/excel-unidiff-cli/tree/main/.codex/skills/cli-guidelines
Command: npx skills add https://github.com/takuto-tanaka-4digit/excel-unidiff-cli --skill cli-guidelines-takuto-tanaka-4digit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive summary and reference for best practices in command-line interface (CLI) design, helping developers create more user-friendly, consistent, and robust tools.

Core Features & Use Cases

  • Design Philosophy: Understand the core principles behind effective CLI design, emphasizing human-first interaction and composability.
  • Practical Guidelines: Learn specific rules for arguments, flags, output, error handling, and configuration.
  • Use Case: A developer is designing a new CLI tool and wants to ensure it follows established best practices for discoverability, usability, and maintainability.

Quick Start

Review the core philosophy behind good CLI design.

Frequently Asked Questions about cli-guidelines

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

FAQPage Schema
What are the best practices for CLI design and user experience?

CLI design best practices emphasize human-first interaction and composability, covering guidelines for help, output, arguments, flags, interactivity, subcommands, robustness, and configuration. Following these principles ensures tools are user-friendly, consistent, and robust.

How do I design command-line interface arguments and flags for discoverability?

To design command-line interface arguments and flags for discoverability, follow specific rules for argument parsing, flag naming, and help text generation. These guidelines ensure users can easily understand and navigate the tool's functionality.

What is the core philosophy behind effective command-line interface design?

Effective command-line interface design philosophy centers on human-first interaction and composability. This means creating tools that are intuitive for users to operate directly and can be easily chained with other commands in Unix-like environments.

How should CLI tools handle errors, signals, and configuration?

CLI tools should handle errors, signals, and configuration by following established guidelines for robustness and future-proofing. This includes managing output formatting, graceful signal interruption, and loading configuration files predictably.

Does this CLI design guide apply to subcommands and interactive prompts?

Yes, this CLI design guide specifically covers guidelines for both subcommands and interactivity. It provides rules for structuring subcommand hierarchies and designing interactive prompts without breaking composability.