302-cli

What problem does it solve?

This Skill helps engineers design Python CLIs that are easy to extend, behave consistently, and are reliable to test, so you avoid brittle command parsing and unclear UX.

Core Features & Use Cases

• Modular subcommand architecture: Build scalable multi-command CLIs (deep command trees) that stay maintainable as the tool grows.
• Framework selection guidance: Choose between Click, Typer, and argparse based on typing, dependency needs, and structure complexity.
• DX-first CLI quality: Enforce descriptive help text, POSIX-compliant exit codes, and better terminal output (including Rich-based TUI patterns).
• Deterministic CLI testing: Test commands with CliRunner-style approaches, isolated filesystems, and ANSI-stripping assertions for Rich output.
• Shell completion and usability hardening: Add completion-ready UX patterns and validate CLI compliance during development.

Quick Start

Use the 302-cli skill to design a new multi-command Python CLI using Click or Typer with fully described options, POSIX exit codes, and a test suite that asserts clean output.