Agent skill · ma08
gws-shared
gws CLI: Shared patterns for authentication, global flags, and output formatting.
What it needs
About 3k tokens when loaded.
What this skill does
gws — Shared Reference Installation The gws binary must be on $PATH. On this machine, ~/pro/botfiles/bin/gws is the preferred wrapper because it can locate the installed CLI even when the NVM bin path is missing. Authentication For Calendar access or any Calendar write, use gws-calendar-safe. Before a human reauthorization, run gws-calendar-safe auth-plan --account <alias> so the exact existing non-Calendar scopes are preserved and the Calendar portion is replaced with only calendar.events plus calendar.calendarlist.readonly. Multi-Account Pattern (This Machine) Prefer named aliases over bare gws whenever mailbox or Drive ownership matters: Saved aliases live under ~/.config/gws/accounts/ and currently map to: work -> sourya4@trymyzone.com personal -> sourya4@gmail.com columbia -> sk5057@columbia.edu Global Flags Flag Description ------ ------------- --format <FORMAT> Output format: json (default), table, yaml, csv --dry-run Validate locally without calling the API --sanitize <TEMPLATE> Screen responses through Model Armor CLI Syntax Method Flags Flag Description ------ ------------- --params '{"key": "val"}' URL/query parameters --json '{"key": "val"}' Request body -o, --output <PATH> Save binary responses to file --upload <PATH> Upload file content (multipart) --page-all Auto-paginate (NDJSON output) --page-limit <N> Max pages when using --page-all (default: 10) --page-delay <MS> Delay between pages in ms (default: 100) Security Rules Never output secrets (API keys, tokens) directly Always confirm with user before executing write/delete commands Explicit “save/create in Gmail drafts” intent is sufficient confirmation for draft creation. A vague “draft an email” request is not. Gmail sending is separate from draft creation and always requires explicit confirmation immediately before sending. Google offers no general draft-only OAuth scope; gmail.compose also grants send capability. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/gws-shared