---
name: tool-name
last_verified: YYYY-MM-DD
# Optional: omit when a useful version cannot be determined.
last_verified_version: "x.y.z"
sources:
  - https://official.example/docs
---

# tool-name

## Purpose

One sentence describing what the CLI does.

## Environment

- Authentication or configuration prerequisites.
- Repository-specific conventions, if durable.

## Common operations

### Operation

```sh
tool-name subcommand --flag VALUE
```

Explain placeholders, expected effects, and safe verification.

## Safety

- Identify destructive or externally visible operations.
- State preview, dry-run, or confirmation options when available.

## Gotchas

- Record durable version, shell, platform, or output-format caveats.

## Discovery

```sh
tool-name --help
tool-name subcommand --help
```