Google Workspace/gws-shared — Agent Skills | officialskills.sh
Back to skills

gws-shared

officialworkflows

Shared foundation for the gws CLI that covers OAuth and service account authentication, global output flags, and common request patterns across all Google Workspace services.

Setup & Installation

npx skills add https://github.com/googleworkspace/cli --skill gws-shared
or paste the link and ask your coding assistant to install it
https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
View on GitHub

What This Skill Does

Shared foundation for the gws CLI that covers OAuth and service account authentication, global output flags, and common request patterns across all Google Workspace services. It defines how the CLI structures commands, handles pagination, uploads files, and screens responses through Model Armor.

Having auth, output formatting, and pagination flags defined once across all gws subcommands means you don't have to re-learn or re-implement these patterns for each Google Workspace service you automate.

When to use it

  • Switching gws output between JSON, CSV, and table formats for different scripts
  • Running a destructive gws command with --dry-run before committing to the API call
  • Authenticating with a service account key file instead of browser-based OAuth
  • Auto-paginating a large Drive file list into a single NDJSON output
  • Screening API responses for PII before piping them to a downstream tool