cli-design-expertlisted

# CLI Design Expert ## Overview This skill provides expert guidance for designing and implementing professional CLI tools with: - **Intuitive UX**: Commands that work as users expect - **Progressive Disclosure**: Simple by default, powerful when needed - **Excellent Help**: Self-documenting commands with rich examples - **Error Recovery**: Helpful errors that guide users to success - **Professional Polish**: Consistent styling, colors, and output formatting ## PROACTIVE USAGE **Invoke this skill before:** - Creating new CLI commands - Designing command structures - Writing help text and documentation - Implementing error messages - Adding interactive prompts --- ## Critical Design Principles ### 1. Command Structure - Follow Git's Model ```bash # Noun-verb pattern (preferred) uam memory query # <tool> <resource> <action> uam worktree create # <tool> <resource> <action> # Common structure <tool> <command> [subcommand] [arguments] [--options] # Examples uam init # Simple command uam init --interactive # With flag uam generate --output ./out # With option value uam memory query "search term" # With argument uam worktree create fix-bug --base develop # Full example ``` ### 2. Option Naming Conventions ```bash # Short + Long options (always provide both for common options) -v, --version # Version -h, --help # Help -o, --output <path> # Output path -f, --force