What problem does it solve?
This Skill helps teams design a consistent CLI surface, capturing commands, arguments, flags, help text, usage syntax, error handling, and configuration rules so automation and humans interact with predictable, well-documented interfaces.
Core Features & Use Cases
- Structured CLI spec: capture the command tree, usage, options, and subcommands with clear semantics.
- Help, output & UX guidelines: define help text, default behavior, and machine-friendly outputs like JSON or plain text.
- Configuration & safety: specify environment/config precedence, prompts, and validation rules to prevent destructive or ambiguous actions.
Quick Start
Draft a CLI spec for a hypothetical tool named backupctl. Define a top-level command with subcommands (e.g., create, list, restore), global flags (e.g., --config, --verbose, --dry-run), and example invocations. Include a usable USAGE synopsis, an options table, and at least two concrete examples showing JSON and plain-text outputs.