human-clilisted

Use when designing, building, reviewing, or evaluating command-line tools for human users -- structures commands with memorable naming and consistent grammar, adds interactive prompts with flag bypasses, implements color-coded output with spinners and progress bars, designs informative error messages with resolution URLs, enforces XDG config paths, adds shell completions and man pages, optimizes startup to under 500ms, implements TTY-aware dual-mode output, and scores CLI human-friendliness on a 0-21 rubric across 7 axes. Triggers on: 'CLI UX', 'human-friendly CLI', 'CLI design', 'CLI colors', 'CLI prompts', 'progress bar', 'CLI help text', 'error messages', 'CLI usability', 'design a CLI', 'evaluate CLI UX'. NOT for agent/machine CLI consumption (use agent-cli). NOT for TUI/full-screen apps. NOT for GUI apps.
wagneripjr/skills · ★ 0 · AI & Automation · score 75

Install: claude install-skill wagneripjr/skills

# Human-Friendly CLI Design & Evaluation **Build mode** (default) — walk through Phases 1-6 to construct a human-first CLI from scratch or retrofit an existing one. **Evaluate mode** — activated when the user says "score", "evaluate", "audit", or "rate" — jump to Phase 7 to score a CLI on the 7-axis human-UX rubric. Targets command-based CLIs (like `git`, `gh`, `rg`, `docker`). ## Quick Decision Guide | Need | Approach | Reference | |------|----------|-----------| | Design command names, grammar, aliases | kebab-case, consistent verb-noun or noun-verb, short aliases | [command-ergonomics.md](references/command-ergonomics.md) | | Add color, tables, icons to output | TTY-aware rendering, NO_COLOR, semantic palette | [visual-output.md](references/visual-output.md) | | Add interactive prompts with automation bypass | Confirm/select/input prompts, `--yes`/`--force` flags | [interactive-input.md](references/interactive-input.md) | | Structure `--help`, add completions, man pages | Help layout, examples section, shell completions, man generation | [help-documentation.md](references/help-documentation.md) | | Add spinners, progress bars, reduce startup time | Lazy loading, spinner on >1s ops, progress bars for file/network | [performance-feedback.md](references/performance-feedback.md) | | XDG paths, config precedence, signal handling | Platform conventions, env > file > defaults, graceful SIGINT | [polish-conventions.md](references/polish-conventions.md) | | Score CLI human-frien