Writing CLI Skills

How to write an agent skill for a command-line tool.

Quick Start

1. Install the tool and play with it — don't just read docs. If the tool is unavailable, use WebFetch on official docs + man pages, but note this in your skill as "not hands-on verified"
2. Run --help on every subcommand
3. Try the common operations yourself
4. Note what surprises you or isn't obvious
5. Copy references/template.md to your new skill directory
6. Fill in sections based on your hands-on experience
7. Delete sections that don't apply

# First: actually use the tool
my-tool --help
my-tool subcommand --help
my-tool do-something  # try it!