gws-shared

Configure authentication, global flags, and output formatting for Google Workspace CLI commands.

1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/juandaniel190/personal-projects --skill gws-shared
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-shared
Source: https://github.com/juandaniel190/personal-projects/tree/main/.claude/skills/Google/gws-shared
Command: npx skills add https://github.com/juandaniel190/personal-projects --skill gws-shared

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides essential shared configurations and patterns for using the Google Workspace CLI (gws), simplifying authentication, global flag management, and output formatting for all gws commands.

Core Features & Use Cases

  • Authentication: Guides users through setting up browser-based OAuth or service account authentication for gws.
  • Global Flags: Details flags for output formatting (--format), dry runs (--dry-run), and content sanitization (--sanitize).
  • CLI Syntax: Explains the general command structure and specific method flags for interacting with Google Workspace services.
  • Security Rules: Enforces best practices for handling secrets, confirming destructive actions, and using dry-run/sanitize flags.
  • Use Case: Before running any gws command, consult this Skill to ensure you have the correct authentication method set up and understand how to control output and security.

Quick Start

Install the gws CLI by running npm install -g @googleworkspace/cli.

Frequently Asked Questions about gws-shared

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

FAQPage Schema
How do I authenticate the Google Workspace CLI?

Google Workspace CLI authentication supports browser-based OAuth and service account methods. You must configure one before executing commands to ensure secure API interactions and proper access to your workspace resources.

What global flags are available for formatting Google Workspace CLI output?

Google Workspace CLI global flags include `--format` for output styling, `--dry-run` for testing actions, and `--sanitize` for content sanitization. These flags control command execution behavior and response formatting across services.

How do I install the Google Workspace command line interface?

Install the Google Workspace CLI globally using the command `npm install -g @googleworkspace/cli`. This provides the foundational command structure and shared patterns required to interact with Google Workspace services.

Can I test destructive Google Workspace API actions before executing them?

Yes, use the `--dry-run` global flag to test destructive Google Workspace API actions. This safety feature lets you preview command execution and changes without actually modifying your workspace data.

What security rules apply when using the Google Workspace CLI?

Google Workspace CLI security rules enforce best practices for handling secrets, confirming destructive actions, and using dry-run and sanitize flags. These rules ensure safe API interactions and protect sensitive workspace data.