42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
# cli-dev
|
|
|
|
Skills for building command-line tools with human-first UX and UNIX composability.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
/plugin install cli-dev@outfitter
|
|
```
|
|
|
|
## Skills
|
|
|
|
| Skill | Purpose |
|
|
|-------|---------|
|
|
| **cli-development-guidelines** | Design and review CLIs: arguments/flags, help text, stdout/stderr, exit codes, interactivity, configuration, errors, and distribution |
|
|
|
|
## Usage
|
|
|
|
The skill activates when you're designing, implementing, or reviewing a CLI tool. Trigger phrases include:
|
|
|
|
- `--help`, flags, subcommands, exit codes
|
|
- stdout/stderr, piping, JSON output
|
|
- color, prompts, config files, env vars
|
|
- "works in CI", install/uninstall, telemetry
|
|
|
|
### What it produces
|
|
|
|
- **CLI contract**: commands, flags, IO behavior, exit codes, config/env, examples
|
|
- **Help output**: example-first, scan-friendly
|
|
- **Compliance audit**: via `scripts/cli_audit.py`
|
|
|
|
### Quick audit
|
|
|
|
```bash
|
|
python cli-dev/skills/cli-development-guidelines/scripts/cli_audit.py -- <your-cli>
|
|
```
|
|
|
|
## License
|
|
|
|
- Documentation: CC-BY-SA-4.0 (adapted from [clig.dev](https://clig.dev/))
|
|
- Scripts: MIT
|