gws-cli

Use this skill when the task should be executed through the Google Workspace CLI instead of handwritten HTTP requests or ad hoc API wrappers.

When to use this skill

• The user asks to interact with Google Drive, Gmail, Sheets, Docs, Slides, Calendar, Chat, Tasks, People, Meet, or Workspace Admin APIs.
• The user wants structured JSON output that is easy for an agent to inspect.
• The user needs to inspect Google API schemas before building a request.
• The user wants a repeatable CLI workflow that can run locally, in CI, or in a headless environment.

Required operating model

1. Confirm that gws is installed and available on PATH.
2. Check authentication status before making API calls.
3. Inspect the target method with gws schema or gws <service> --help before composing flags.
4. Prefer read-only commands first.
5. For write, update, or delete operations, confirm intent with the user before execution.
6. Prefer --dry-run when the command supports local validation and the operation is risky.