tbroadley/gws-shared
claude/skills/gws-shared/SKILL.md
gws CLI: Shared patterns for authentication, global flags, and output formatting.
tools
Updated Apr 15, 2026
$ install --global
skillsauthnpx skillsauth add tbroadley/dotfiles gws-sharedInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 2:13 AM92.8s1 file scanned
SKILL.md
- name:
- gws-shared
- description:
- gws CLI: Shared patterns for authentication, global flags, and output formatting.
gws — Shared Reference
Installation
npm install -g @googleworkspace/cli
Authentication
gws auth setup cannot automatically create OAuth clients. Instead, create one manually in the
Google Cloud Console
(Desktop app type), then set the env vars and login:
# In ~/.zshrc.local
export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
# Login (opens browser for OAuth consent)
gws auth login
# Or select specific services to stay under scope limits (unverified apps cap at ~25 scopes)
gws auth login -s drive,gmail,calendar,sheets,docs
Re-login if you see invalid_grant errors (tokens expired):
gws auth login
Global Flags
| Flag | Description |
|------|-------------|
| --format <FORMAT> | Output format: json (default), table, yaml, csv |
| --dry-run | Validate locally without calling the API |
CLI Syntax
gws <service> <resource> [sub-resource] <method> [flags]
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) |
Discovering Commands
# Browse resources and methods
gws <service> --help
# Inspect a method's required params, types, and defaults
gws schema <service>.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Related Skills
tbroadley/wispr-dictionary
tools
VerifiedTrustedCommunity
Add words to the Wispr Flow dictionary. Use when the user wants to add a word, phrase, or snippet to Wispr Flow for voice dictation.
SKILL.mdUpdated Apr 15, 2026
tbroadley/upload-pr-images
documentation
VerifiedTrustedCommunity
Upload images to a GitHub PR description or comment using a shared gist as image hosting. Use when the user wants to add plots, screenshots, or other images to a PR.
SKILL.mdUpdated Apr 15, 2026
tbroadley/todoist
testing
VerifiedTrustedCommunity
Manage tasks, projects, and productivity in Todoist. View tasks, add new items, check completed work, and organize projects.
SKILL.mdUpdated Apr 15, 2026
tbroadley/rebase-stack
data-ai
VerifiedTrustedCommunity
Use when working with stacked diffs (branch B based on branch A, which is based on main).
SKILL.mdUpdated Apr 15, 2026