gws-shared

Standardize gws CLI authentication and flags across Google Workspace accounts.

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-shared-ma08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-shared
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-shared
Command: npx skills add https://github.com/ma08/botfiles --skill gws-shared-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of inconsistent gws CLI usage across multiple Google Workspace accounts, removing the need to repeatedly figure out authentication flows, flag syntax, and shell quoting rules for common productivity tasks like Gmail triage, Drive file management, and Sheets data retrieval.

Core Features & Use Cases

  • Multi-account authentication management: Seamlessly switch between work, personal, and institutional Google accounts without re-authenticating for each session.
  • Standardized global flag guidance: Consistent rules for output formatting, dry-run validation, and PII sanitization across all gws service commands.
  • Shell compatibility troubleshooting: Clear examples to avoid common zsh history expansion and JSON quoting errors when running gws commands for Drive searches, Sheets range reads, and other operations.
  • Use Case: For users managing multiple Google Workspace accounts who need to automate routine tasks without wasting time fixing authentication or shell syntax errors.

Quick Start

Ask your agent to use the gws-shared skill to retrieve the 5 most recent unread emails from your pre-configured work Gmail account in JSON format.

Frequently Asked Questions about gws-shared

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage multiple Google Workspace accounts with the gws CLI?

Multi-account authentication management allows you to seamlessly switch between work, personal, and institutional Google accounts without re-authenticating for each gws CLI session.

How do I fix JSON quoting and zsh history expansion errors when running gws commands?

Shell compatibility troubleshooting provides clear examples to avoid common zsh history expansion and JSON quoting errors during Drive searches, Sheets range reads, and other gws operations.

What is the best way to standardize output formatting and PII sanitization across gws CLI commands?

Standardized global flag guidance enforces consistent rules for output formatting, PII sanitization, and dry-run validation across all gws service commands to protect sensitive data.

Can I use the gws CLI to retrieve unread Gmail emails in JSON format?

Yes, you can retrieve recent unread emails from pre-configured Google accounts in JSON format by applying standardized output formatting flags to your gws Gmail triage commands.

Does the gws CLI support dry-run validation for destructive Drive file management operations?

Yes, dry-run validation is supported as a standardized global flag to verify destructive operations and prevent accidental data loss during Google Workspace service interactions.