| name | usps-cli |
| description | Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute usps operations using the `usps` CLI tool. CLI interface for USPS Tracking API -- track packages by tracking number. Triggers: usps, usps cli, usps tracking, track package, track usps, usps package, package tracking, where is my package, shipping status usps |
Execute usps operations using the `usps` CLI. All usps interactions should use this CLI.
<quick_start>
The usps CLI follows this pattern:
usps <command-group> <action> [arguments] [options]
| Task | Command |
|---|
| Track a package | usps tracking get TRACKING_NUMBER |
| Track a package (table) | usps tracking get TRACKING_NUMBER --table |
| Track multiple packages | usps tracking list NUM1 NUM2 NUM3 --table |
| Filter delivered packages | usps tracking list NUM1 NUM2 --filter "status:eq:Delivered" |
| Check auth status | usps auth status |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY usps command.
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
- **auth** — Manage USPS API authentication (OAuth 2.0 client credentials)
- **tracking** — Track packages: get single package info, list/batch-track multiple packages
<reference_index>
usage.json — Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
