[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DRZY5WWEEV45KZZR1FR3HC":3,"skill-same:01M6DRZY5WWEEV45KZZR1FR3HC":158},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":55,"install":56,"resources":69},"01M6DRZY5WWEEV45KZZR1FR3HC","google-workspace-cli",null,"Google Workspace administration via the gws CLI. Install, authenticate, and automate Gmail, Drive, Sheets, Calendar, Docs, Chat, and Tasks. Run security audits, execute 43 built-in recipes, and use 10 persona bundles. Use for Google Workspace admin, gws CLI setup, Gmail automation, Drive management, or Calendar scheduling.","zhangzhang-111-i\u002Fclaude-skills111","zhangzhang-111-i","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F251344927?v=4","01M6DRBP4NCM1ZCHTT0FW0SQHD","lixiying","01M6DRBPAMFDJSGQ69XPK9KM9J",4,"MIT","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"google","google workspace cli","workspace","google workspace","cli","security","automation","tasks","run","persona","automate","gmail","install","use","calendar","scheduling","gmail automation","gws","chat","recipes","2026-11-10 10:12:30",false,"---\nname: \"google-workspace-cli\"\ndescription: \"Google Workspace administration via the gws CLI. Install, authenticate, and automate Gmail, Drive, Sheets, Calendar, Docs, Chat, and Tasks. Run security audits, execute 43 built-in recipes, and use 10 persona bundles. Use for Google Workspace admin, gws CLI setup, Gmail automation, Drive management, or Calendar scheduling.\"\n---\n\n# Google Workspace CLI\n\nExpert guidance and automation for Google Workspace administration using the open-source `gws` CLI. Covers installation, authentication, 18+ service APIs, 43 built-in recipes, and 10 persona bundles for role-based workflows.\n\n---\n\n## Quick Start\n\n### Check Installation\n\n```bash\n# Verify gws is installed and authenticated\npython3 scripts\u002Fgws_doctor.py\n```\n\n### Send an Email\n\n```bash\ngws gmail users.messages send me --to \"team@company.com\" \\\n  --subject \"Weekly Update\" --body \"Here's this week's summary...\"\n```\n\n### List Drive Files\n\n```bash\ngws drive files list --json --limit 20 | python3 scripts\u002Foutput_analyzer.py --select \"name,mimeType,modifiedTime\" --format table\n```\n\n---\n\n## Installation\n\n### npm (recommended)\n\n```bash\nnpm install -g @anthropic\u002Fgws\ngws --version\n```\n\n### Cargo (from source)\n\n```bash\ncargo install gws-cli\ngws --version\n```\n\n### Pre-built Binaries\n\nDownload from [github.com\u002Fgoogleworkspace\u002Fcli\u002Freleases](https:\u002F\u002Fgithub.com\u002Fgoogleworkspace\u002Fcli\u002Freleases) for macOS, Linux, or Windows.\n\n### Verify Installation\n\n```bash\npython3 scripts\u002Fgws_doctor.py\n# Checks: PATH, version, auth status, service connectivity\n```\n\n---\n\n## Authentication\n\n### OAuth Setup (Interactive)\n\n```bash\n# Step 1: Create Google Cloud project and OAuth credentials\npython3 scripts\u002Fauth_setup_guide.py --guide oauth\n\n# Step 2: Run auth setup\ngws auth setup\n\n# Step 3: Validate\ngws auth status --json\n```\n\n### Service Account (Headless\u002FCI)\n\n```bash\n# Generate setup instructions\npython3 scripts\u002Fauth_setup_guide.py --guide service-account\n\n# Configure with key file\nexport GWS_SERVICE_ACCOUNT_KEY=\u002Fpath\u002Fto\u002Fkey.json\nexport GWS_DELEGATED_USER=admin@company.com\ngws auth status\n```\n\n### Environment Variables\n\n```bash\n# Generate .env template\npython3 scripts\u002Fauth_setup_guide.py --generate-env\n```\n\n| Variable | Purpose |\n|----------|---------|\n| `GWS_CLIENT_ID` | OAuth client ID |\n| `GWS_CLIENT_SECRET` | OAuth client secret |\n| `GWS_TOKEN_PATH` | Custom token storage path |\n| `GWS_SERVICE_ACCOUNT_KEY` | Service account JSON key path |\n| `GWS_DELEGATED_USER` | User to impersonate (service accounts) |\n| `GWS_DEFAULT_FORMAT` | Default output format (json\u002Fndjson\u002Ftable) |\n\n### Validate Authentication\n\n```bash\npython3 scripts\u002Fauth_setup_guide.py --validate --json\n# Tests each service endpoint\n```\n\n---\n\n## Workflow 1: Gmail Automation\n\n**Goal:** Automate email operations — send, search, label, and filter management.\n\n### Send and Reply\n\n```bash\n# Send a new email\ngws gmail users.messages send me --to \"client@example.com\" \\\n  --subject \"Proposal\" --body \"Please find attached...\" \\\n  --attachment proposal.pdf\n\n# Reply to a thread\ngws gmail users.messages reply me --thread-id \u003CTHREAD_ID> \\\n  --body \"Thanks for your feedback...\"\n\n# Forward a message\ngws gmail users.messages forward me --message-id \u003CMSG_ID> \\\n  --to \"manager@company.com\"\n```\n\n### Search and Filter\n\n```bash\n# Search emails\ngws gmail users.messages list me --query \"from:client@example.com after:2025\u002F01\u002F01\" --json \\\n  | python3 scripts\u002Foutput_analyzer.py --count\n\n# List labels\ngws gmail users.labels list me --json\n\n# Create a filter\ngws gmail users.settings.filters create me \\\n  --criteria '{\"from\":\"notifications@service.com\"}' \\\n  --action '{\"addLabelIds\":[\"Label_123\"],\"removeLabelIds\":[\"INBOX\"]}'\n```\n\n### Bulk Operations\n\n```bash\n# Archive all read emails older than 30 days\ngws gmail users.messages list me --query \"is:read older_than:30d\" --json \\\n  | python3 scripts\u002Foutput_analyzer.py --select \"id\" --format json \\\n  | xargs -I {} gws gmail users.messages modify me {} --removeLabelIds INBOX\n```\n\n---\n\n## Workflow 2: Drive & Sheets\n\n**Goal:** Manage files, create spreadsheets, configure sharing, and export data.\n\n### File Operations\n\n```bash\n# List files\ngws drive files list --json --limit 50 \\\n  | python3 scripts\u002Foutput_analyzer.py --select \"name,mimeType,size\" --format table\n\n# Upload a file\ngws drive files create --name \"Q1 Report\" --upload report.pdf \\\n  --parents \u003CFOLDER_ID>\n\n# Create a Google Sheet\ngws sheets spreadsheets create --title \"Budget 2026\" --json\n\n# Download\u002Fexport\ngws drive files export \u003CFILE_ID> --mime \"application\u002Fpdf\" --output report.pdf\n```\n\n### Sharing\n\n```bash\n# Share with user\ngws drive permissions create \u003CFILE_ID> \\\n  --type user --role writer --emailAddress \"colleague@company.com\"\n\n# Share with domain (view only)\ngws drive permissions create \u003CFILE_ID> \\\n  --type domain --role reader --domain \"company.com\"\n\n# List who has access\ngws drive permissions list \u003CFILE_ID> --json\n```\n\n### Sheets Data\n\n```bash\n# Read a range\ngws sheets spreadsheets.values get \u003CSHEET_ID> --range \"Sheet1!A1:D10\" --json\n\n# Write data\ngws sheets spreadsheets.values update \u003CSHEET_ID> --range \"Sheet1!A1\" \\\n  --values '[[\"Name\",\"Score\"],[\"Alice\",95],[\"Bob\",87]]'\n\n# Append rows\ngws sheets spreadsheets.values append \u003CSHEET_ID> --range \"Sheet1!A1\" \\\n  --values '[[\"Charlie\",92]]'\n```\n\n---\n\n## Workflow 3: Calendar & Meetings\n\n**Goal:** Schedule events, find available times, and generate standup reports.\n\n### Event Management\n\n```bash\n# Create an event\ngws calendar events insert primary \\\n  --summary \"Sprint Planning\" \\\n  --start \"2026-03-15T10:00:00\" --end \"2026-03-15T11:00:00\" \\\n  --attendees \"team@company.com\" \\\n  --location \"Conference Room A\"\n\n# List upcoming events\ngws calendar events list primary --timeMin \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" \\\n  --maxResults 10 --json\n\n# Quick event (natural language)\ngws helpers quick-event \"Lunch with Sarah tomorrow at noon\"\n```\n\n### Find Available Time\n\n```bash\n# Check free\u002Fbusy for multiple people\ngws helpers find-time \\\n  --attendees \"alice@co.com,bob@co.com,charlie@co.com\" \\\n  --duration 60 --within \"2026-03-15,2026-03-19\" --json\n```\n\n### Standup Report\n\n```bash\n# Generate daily standup from calendar + tasks\ngws recipes standup-report --json \\\n  | python3 scripts\u002Foutput_analyzer.py --format table\n\n# Meeting prep (agenda + attendee info)\ngws recipes meeting-prep --event-id \u003CEVENT_ID>\n```\n\n---\n\n## Workflow 4: Security Audit\n\n**Goal:** Audit Google Workspace security configuration and generate remediation commands.\n\n### Run Full Audit\n\n```bash\n# Full audit across all services\npython3 scripts\u002Fworkspace_audit.py --json\n\n# Audit specific services\npython3 scripts\u002Fworkspace_audit.py --services gmail,drive,calendar\n\n# Demo mode (no gws required)\npython3 scripts\u002Fworkspace_audit.py --demo\n```\n\n### Audit Checks\n\n| Area | Check | Risk |\n|------|-------|------|\n| Drive | External sharing enabled | Data exfiltration |\n| Gmail | Auto-forwarding rules | Data exfiltration |\n| Gmail | DMARC\u002FSPF\u002FDKIM records | Email spoofing |\n| Calendar | Default sharing visibility | Information leak |\n| OAuth | Third-party app grants | Unauthorized access |\n| Admin | Super admin count | Privilege escalation |\n| Admin | 2-Step verification enforcement | Account takeover |\n\n### Review and Remediate\n\n```bash\n# Review findings\npython3 scripts\u002Fworkspace_audit.py --json | python3 scripts\u002Foutput_analyzer.py \\\n  --filter \"status=FAIL\" --select \"area,check,remediation\"\n\n# Execute remediation (example: restrict external sharing)\ngws drive about get --json  # Check current settings\n# Follow remediation commands from audit output\n```\n\n---\n\n## Python Tools\n\n| Script | Purpose | Usage |\n|--------|---------|-------|\n| `gws_doctor.py` | Pre-flight diagnostics | `python3 scripts\u002Fgws_doctor.py [--json] [--services gmail,drive]` |\n| `auth_setup_guide.py` | Guided auth setup | `python3 scripts\u002Fauth_setup_guide.py --guide oauth` |\n| `gws_recipe_runner.py` | Recipe catalog & runner | `python3 scripts\u002Fgws_recipe_runner.py --list [--persona pm]` |\n| `workspace_audit.py` | Security\u002Fconfig audit | `python3 scripts\u002Fworkspace_audit.py [--json] [--demo]` |\n| `output_analyzer.py` | JSON\u002FNDJSON analysis | `gws ... --json \\| python3 scripts\u002Foutput_analyzer.py --count` |\n\nAll scripts are stdlib-only, support `--json` output, and include demo mode with embedded sample data.\n\n---\n\n## Best Practices\n\n### Security\n\n1. Use OAuth with minimal scopes — request only what each workflow needs\n2. Store tokens in the system keyring, never in plain text files\n3. Rotate service account keys every 90 days\n4. Audit third-party OAuth app grants quarterly\n5. Use `--dry-run` before bulk destructive operations\n\n### Automation\n\n1. Pipe `--json` output through `output_analyzer.py` for filtering and aggregation\n2. Use recipes for multi-step operations instead of chaining raw commands\n3. Select a persona bundle to scope recipes to your role\n4. Use NDJSON format (`--format ndjson`) for streaming large result sets\n5. Set `GWS_DEFAULT_FORMAT=json` in your shell profile for scripting\n\n### Performance\n\n1. Use `--fields` to request only needed fields (reduces payload size)\n2. Use `--limit` to cap results when browsing\n3. Use `--page-all` only when you need complete datasets\n4. Batch operations with recipes rather than individual API calls\n5. Cache frequently accessed data (e.g., label IDs, folder IDs) in variables\n\n---\n\n## Limitations\n\n| Constraint | Impact |\n|------------|--------|\n| OAuth tokens expire after 1 hour | Re-auth needed for long-running scripts |\n| API rate limits (per-user, per-service) | Bulk operations may hit 429 errors |\n| Scope requirements vary by service | Must request correct scopes during auth |\n| Pre-v1.0 CLI status | Breaking changes possible between releases |\n| Google Cloud project required | Free, but requires setup in Cloud Console |\n| Admin API needs admin privileges | Some audit checks require Workspace Admin role |\n\n### Required Scopes by Service\n\n```bash\n# List scopes for specific services\npython3 scripts\u002Fauth_setup_guide.py --scopes gmail,drive,calendar,sheets\n```\n\n| Service | Key Scopes |\n|---------|-----------|\n| Gmail | `gmail.modify`, `gmail.send`, `gmail.labels` |\n| Drive | `drive.file`, `drive.metadata.readonly` |\n| Sheets | `spreadsheets` |\n| Calendar | `calendar`, `calendar.events` |\n| Admin | `admin.directory.user.readonly`, `admin.directory.group` |\n| Tasks | `tasks` |\n","# Google Workspace CLI\n\nExpert guidance and automation for Google Workspace administration using the open-source `gws` CLI. Covers installation, authentication, 18+ service APIs, 43 built-in recipes, and 10 persona bundles for role-based workflows.\n\n---\n\n## Quick Start\n\n### Check Installation\n\n```bash\n# Verify gws is installed and authenticated\npython3 scripts\u002Fgws_doctor.py\n```\n\n### Send an Email\n\n```bash\ngws gmail users.messages send me --to \"team@company.com\" \\\n  --subject \"Weekly Update\" --body \"Here's this week's summary...\"\n```\n\n### List Drive Files\n\n```bash\ngws drive files list --json --limit 20 | python3 scripts\u002Foutput_analyzer.py --select \"name,mimeType,modifiedTime\" --format table\n```\n\n---\n\n## Installation\n\n### npm (recommended)\n\n```bash\nnpm install -g @anthropic\u002Fgws\ngws --version\n```\n\n### Cargo (from source)\n\n```bash\ncargo install gws-cli\ngws --version\n```\n\n### Pre-built Binaries\n\nDownload from [github.com\u002Fgoogleworkspace\u002Fcli\u002Freleases](https:\u002F\u002Fgithub.com\u002Fgoogleworkspace\u002Fcli\u002Freleases) for macOS, Linux, or Windows.\n\n### Verify Installation\n\n```bash\npython3 scripts\u002Fgws_doctor.py\n# Checks: PATH, version, auth status, service connectivity\n```\n\n---\n\n## Authentication\n\n### OAuth Setup (Interactive)\n\n```bash\n# Step 1: Create Google Cloud project and OAuth credentials\npython3 scripts\u002Fauth_setup_guide.py --guide oauth\n\n# Step 2: Run auth setup\ngws auth setup\n\n# Step 3: Validate\ngws auth status --json\n```\n\n### Service Account (Headless\u002FCI)\n\n```bash\n# Generate setup instructions\npython3 scripts\u002Fauth_setup_guide.py --guide service-account\n\n# Configure with key file\nexport GWS_SERVICE_ACCOUNT_KEY=\u002Fpath\u002Fto\u002Fkey.json\nexport GWS_DELEGATED_USER=admin@company.com\ngws auth status\n```\n\n### Environment Variables\n\n```bash\n# Generate .env template\npython3 scripts\u002Fauth_setup_guide.py --generate-env\n```\n\n| Variable | Purpose |\n|----------|---------|\n| `GWS_CLIENT_ID` | OAuth client ID |\n| `GWS_CLIENT_SECRET` | OAuth client secret |\n| `GWS_TOKEN_PATH` | Custom token storage path |\n| `GWS_SERVICE_ACCOUNT_KEY` | Service account JSON key path |\n| `GWS_DELEGATED_USER` | User to impersonate (service accounts) |\n| `GWS_DEFAULT_FORMAT` | Default output format (json\u002Fndjson\u002Ftable) |\n\n### Validate Authentication\n\n```bash\npython3 scripts\u002Fauth_setup_guide.py --validate --json\n# Tests each service endpoint\n```\n\n---\n\n## Workflow 1: Gmail Automation\n\n**Goal:** Automate email operations — send, search, label, and filter management.\n\n### Send and Reply\n\n```bash\n# Send a new email\ngws gmail users.messages send me --to \"client@example.com\" \\\n  --subject \"Proposal\" --body \"Please find attached...\" \\\n  --attachment proposal.pdf\n\n# Reply to a thread\ngws gmail users.messages reply me --thread-id \u003CTHREAD_ID> \\\n  --body \"Thanks for your feedback...\"\n\n# Forward a message\ngws gmail users.messages forward me --message-id \u003CMSG_ID> \\\n  --to \"manager@company.com\"\n```\n\n### Search and Filter\n\n```bash\n# Search emails\ngws gmail users.messages list me --query \"from:client@example.com after:2025\u002F01\u002F01\" --json \\\n  | python3 scripts\u002Foutput_analyzer.py --count\n\n# List labels\ngws gmail users.labels list me --json\n\n# Create a filter\ngws gmail users.settings.filters create me \\\n  --criteria '{\"from\":\"notifications@service.com\"}' \\\n  --action '{\"addLabelIds\":[\"Label_123\"],\"removeLabelIds\":[\"INBOX\"]}'\n```\n\n### Bulk Operations\n\n```bash\n# Archive all read emails older than 30 days\ngws gmail users.messages list me --query \"is:read older_than:30d\" --json \\\n  | python3 scripts\u002Foutput_analyzer.py --select \"id\" --format json \\\n  | xargs -I {} gws gmail users.messages modify me {} --removeLabelIds INBOX\n```\n\n---\n\n## Workflow 2: Drive & Sheets\n\n**Goal:** Manage files, create spreadsheets, configure sharing, and export data.\n\n### File Operations\n\n```bash\n# List files\ngws drive files list --json --limit 50 \\\n  | python3 scripts\u002Foutput_analyzer.py --select \"name,mimeType,size\" --format table\n\n# Upload a file\ngws drive files create --name \"Q1 Report\" --upload report.pdf \\\n  --parents \u003CFOLDER_ID>\n\n# Create a Google Sheet\ngws sheets spreadsheets create --title \"Budget 2026\" --json\n\n# Download\u002Fexport\ngws drive files export \u003CFILE_ID> --mime \"application\u002Fpdf\" --output report.pdf\n```\n\n### Sharing\n\n```bash\n# Share with user\ngws drive permissions create \u003CFILE_ID> \\\n  --type user --role writer --emailAddress \"colleague@company.com\"\n\n# Share with domain (view only)\ngws drive permissions create \u003CFILE_ID> \\\n  --type domain --role reader --domain \"company.com\"\n\n# List who has access\ngws drive permissions list \u003CFILE_ID> --json\n```\n\n### Sheets Data\n\n```bash\n# Read a range\ngws sheets spreadsheets.values get \u003CSHEET_ID> --range \"Sheet1!A1:D10\" --json\n\n# Write data\ngws sheets spreadsheets.values update \u003CSHEET_ID> --range \"Sheet1!A1\" \\\n  --values '[[\"Name\",\"Score\"],[\"Alice\",95],[\"Bob\",87]]'\n\n# Append rows\ngws sheets spreadsheets.values append \u003CSHEET_ID> --range \"Sheet1!A1\" \\\n  --values '[[\"Charlie\",92]]'\n```\n\n---\n\n## Workflow 3: Calendar & Meetings\n\n**Goal:** Schedule events, find available times, and generate standup reports.\n\n### Event Management\n\n```bash\n# Create an event\ngws calendar events insert primary \\\n  --summary \"Sprint Planning\" \\\n  --start \"2026-03-15T10:00:00\" --end \"2026-03-15T11:00:00\" \\\n  --attendees \"team@company.com\" \\\n  --location \"Conference Room A\"\n\n# List upcoming events\ngws calendar events list primary --timeMin \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" \\\n  --maxResults 10 --json\n\n# Quick event (natural language)\ngws helpers quick-event \"Lunch with Sarah tomorrow at noon\"\n```\n\n### Find Available Time\n\n```bash\n# Check free\u002Fbusy for multiple people\ngws helpers find-time \\\n  --attendees \"alice@co.com,bob@co.com,charlie@co.com\" \\\n  --duration 60 --within \"2026-03-15,2026-03-19\" --json\n```\n\n### Standup Report\n\n```bash\n# Generate daily standup from calendar + tasks\ngws recipes standup-report --json \\\n  | python3 scripts\u002Foutput_analyzer.py --format table\n\n# Meeting prep (agenda + attendee info)\ngws recipes meeting-prep --event-id \u003CEVENT_ID>\n```\n\n---\n\n## Workflow 4: Security Audit\n\n**Goal:** Audit Google Workspace security configuration and generate remediation commands.\n\n### Run Full Audit\n\n```bash\n# Full audit across all services\npython3 scripts\u002Fworkspace_audit.py --json\n\n# Audit specific services\npython3 scripts\u002Fworkspace_audit.py --services gmail,drive,calendar\n\n# Demo mode (no gws required)\npython3 scripts\u002Fworkspace_audit.py --demo\n```\n\n### Audit Checks\n\n| Area | Check | Risk |\n|------|-------|------|\n| Drive | External sharing enabled | Data exfiltration |\n| Gmail | Auto-forwarding rules | Data exfiltration |\n| Gmail | DMARC\u002FSPF\u002FDKIM records | Email spoofing |\n| Calendar | Default sharing visibility | Information leak |\n| OAuth | Third-party app grants | Unauthorized access |\n| Admin | Super admin count | Privilege escalation |\n| Admin | 2-Step verification enforcement | Account takeover |\n\n### Review and Remediate\n\n```bash\n# Review findings\npython3 scripts\u002Fworkspace_audit.py --json | python3 scripts\u002Foutput_analyzer.py \\\n  --filter \"status=FAIL\" --select \"area,check,remediation\"\n\n# Execute remediation (example: restrict external sharing)\ngws drive about get --json  # Check current settings\n# Follow remediation commands from audit output\n```\n\n---\n\n## Python Tools\n\n| Script | Purpose | Usage |\n|--------|---------|-------|\n| `gws_doctor.py` | Pre-flight diagnostics | `python3 scripts\u002Fgws_doctor.py [--json] [--services gmail,drive]` |\n| `auth_setup_guide.py` | Guided auth setup | `python3 scripts\u002Fauth_setup_guide.py --guide oauth` |\n| `gws_recipe_runner.py` | Recipe catalog & runner | `python3 scripts\u002Fgws_recipe_runner.py --list [--persona pm]` |\n| `workspace_audit.py` | Security\u002Fconfig audit | `python3 scripts\u002Fworkspace_audit.py [--json] [--demo]` |\n| `output_analyzer.py` | JSON\u002FNDJSON analysis | `gws ... --json \\| python3 scripts\u002Foutput_analyzer.py --count` |\n\nAll scripts are stdlib-only, support `--json` output, and include demo mode with embedded sample data.\n\n---\n\n## Best Practices\n\n### Security\n\n1. Use OAuth with minimal scopes — request only what each workflow needs\n2. Store tokens in the system keyring, never in plain text files\n3. Rotate service account keys every 90 days\n4. Audit third-party OAuth app grants quarterly\n5. Use `--dry-run` before bulk destructive operations\n\n### Automation\n\n1. Pipe `--json` output through `output_analyzer.py` for filtering and aggregation\n2. Use recipes for multi-step operations instead of chaining raw commands\n3. Select a persona bundle to scope recipes to your role\n4. Use NDJSON format (`--format ndjson`) for streaming large result sets\n5. Set `GWS_DEFAULT_FORMAT=json` in your shell profile for scripting\n\n### Performance\n\n1. Use `--fields` to request only needed fields (reduces payload size)\n2. Use `--limit` to cap results when browsing\n3. Use `--page-all` only when you need complete datasets\n4. Batch operations with recipes rather than individual API calls\n5. Cache frequently accessed data (e.g., label IDs, folder IDs) in variables\n\n---\n\n## Limitations\n\n| Constraint | Impact |\n|------------|--------|\n| OAuth tokens expire after 1 hour | Re-auth needed for long-running scripts |\n| API rate limits (per-user, per-service) | Bulk operations may hit 429 errors |\n| Scope requirements vary by service | Must request correct scopes during auth |\n| Pre-v1.0 CLI status | Breaking changes possible between releases |\n| Google Cloud project required | Free, but requires setup in Cloud Console |\n| Admin API needs admin privileges | Some audit checks require Workspace Admin role |\n\n### Required Scopes by Service\n\n```bash\n# List scopes for specific services\npython3 scripts\u002Fauth_setup_guide.py --scopes gmail,drive,calendar,sheets\n```\n\n| Service | Key Scopes |\n|---------|-----------|\n| Gmail | `gmail.modify`, `gmail.send`, `gmail.labels` |\n| Drive | `drive.file`, `drive.metadata.readonly` |\n| Sheets | `spreadsheets` |\n| Calendar | `calendar`, `calendar.events` |\n| Admin | `admin.directory.user.readonly`, `admin.directory.group` |\n| Tasks | `tasks` |\n",{"name":5,"description":7},"main","c0a12fc98d85642fa8893e31fc5cf5dfad879de6","engineering-team\u002Fgoogle-workspace-cli",0,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i","2026-03-13 21:49:18",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add zhangzhang-111-i\u002Fclaude-skills111 --skill google-workspace-cli",{"tool":62,"command":63},"bunx","bunx skills add zhangzhang-111-i\u002Fclaude-skills111 --skill google-workspace-cli",{"tool":65,"command":66},"pnpm","pnpm dlx skills add zhangzhang-111-i\u002Fclaude-skills111 --skill google-workspace-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002FSKILL.md",true,[70,76,82,86,92,96,100,104,108,112,116,120,124,128,132,138,142,146,150,154],{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},".claude-plugin\u002Fplugin.json","REFERENCE","参考文档",563,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002F.claude-plugin\u002Fplugin.json",{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},".gitignore","OTHER","其他",106,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002F.gitignore",{"path":83,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":84,"sourceHtmlUrl":85},"algorithms.md",97,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Falgorithms.md",{"path":87,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":90,"sourceHtmlUrl":91},"assets\u002Fpersona-profiles.md","ASSET","资产文件",8075,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fassets\u002Fpersona-profiles.md",{"path":93,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":94,"sourceHtmlUrl":95},"assets\u002Fworkspace-config.json",1762,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fassets\u002Fworkspace-config.json",{"path":97,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":98,"sourceHtmlUrl":99},"failure_modes.md",100,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Ffailure_modes.md",{"path":101,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":102,"sourceHtmlUrl":103},"formulas.md",95,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Fformulas.md",{"path":105,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":106,"sourceHtmlUrl":107},"implementation_notes.md",107,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Fimplementation_notes.md",{"path":109,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":110,"sourceHtmlUrl":111},"integration_arbitragex.md",109,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Fintegration_arbitragex.md",{"path":113,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":114,"sourceHtmlUrl":115},"manifest.json",854,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Fmanifest.json",{"path":117,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":118,"sourceHtmlUrl":119},"references.json",287,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Freferences.json",{"path":121,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":122,"sourceHtmlUrl":123},"references\u002Fgws-command-reference.md",10717,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Freferences\u002Fgws-command-reference.md",{"path":125,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":126,"sourceHtmlUrl":127},"references\u002Frecipes-cookbook.md",8510,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Freferences\u002Frecipes-cookbook.md",{"path":129,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":130,"sourceHtmlUrl":131},"references\u002Ftroubleshooting.md",6796,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Freferences\u002Ftroubleshooting.md",{"path":133,"resourceType":134,"resourceTypeDesc":135,"sizeBytes":136,"sourceHtmlUrl":137},"scripts\u002Fauth_setup_guide.py","SCRIPT","脚本",13112,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fscripts\u002Fauth_setup_guide.py",{"path":139,"resourceType":134,"resourceTypeDesc":135,"sizeBytes":140,"sourceHtmlUrl":141},"scripts\u002Fgws_doctor.py",9014,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fscripts\u002Fgws_doctor.py",{"path":143,"resourceType":134,"resourceTypeDesc":135,"sizeBytes":144,"sourceHtmlUrl":145},"scripts\u002Fgws_recipe_runner.py",20205,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fscripts\u002Fgws_recipe_runner.py",{"path":147,"resourceType":134,"resourceTypeDesc":135,"sizeBytes":148,"sourceHtmlUrl":149},"scripts\u002Foutput_analyzer.py",11636,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fscripts\u002Foutput_analyzer.py",{"path":151,"resourceType":134,"resourceTypeDesc":135,"sizeBytes":152,"sourceHtmlUrl":153},"scripts\u002Fworkspace_audit.py",11154,"https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fengineering-team\u002Fgoogle-workspace-cli\u002Fscripts\u002Fworkspace_audit.py",{"path":155,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":156,"sourceHtmlUrl":157},"validation_tests.md",103,"https:\u002F\u002Fgithub.com\u002Fhefarica\u002Farbitragex-v2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgas-aware-profitability-model\u002Fvalidation_tests.md",[159,185,211,240,260,283],{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":165,"publishedAt":44},"01M6DSNYM8PZKEXGYMRX53PVPH","risk-management-specialist","Medical device risk management specialist implementing ISO 14971 throughout product lifecycle. Provides risk analysis, risk evaluation, risk control, and post-production information analysis. Use when user mentions risk management, ISO 14971, risk analysis, FMEA, fault tree analysis, hazard identification, risk control, risk matrix, benefit-risk analysis, residual risk, risk acceptability, or post-market risk.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Frisk-management-specialist\u002FSKILL.md",[],[166,167,168,169,170,171,172,173,174,175,176,177,37,178,179,180,181,182,183,184],"risk","risk management specialist","management","risk management","risk analysis","risk evaluation","product","Evaluation","Production","lifecycle","analysis","user","risk matrix","Market","device","control","iso","medical","iso 14971",{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":191,"publishedAt":44},"01M6DSNSRBGVZWS23TK0ZQ52QC","regulatory-affairs-head","Senior Regulatory Affairs Manager for HealthTech and MedTech companies. Prepares FDA 510(k), De Novo, and PMA submission packages; analyzes regulatory pathways for new medical devices; drafts responses to FDA deficiency letters and Notified Body queries; develops CE marking technical documentation under EU MDR 2017\u002F745; coordinates multi-market approval strategies across FDA, EU, Health Canada, PMDA, and NMPA; and maintains regulatory intelligence on evolving standards. Use when users need to plan or execute FDA submissions, navigate 510(k) or PMA approval processes, achieve CE marking, prepare pre-submission meeting materials, write regulatory strategy documents, respond to agency queries, or manage compliance documentation for medical device market access.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Fregulatory-affairs-head\u002FSKILL.md",[],[192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,183,210],"regulatory affairs head","regulatory","head","documentation","documents","packages","planning","devices","plan","access","write","strategy","evidence","standards","manage","intelligence","across","strategies","clinical",{"skillNo":212,"name":213,"nameZh":6,"description":214,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":215,"categories":216,"keywords":225,"publishedAt":44},"01M6DSNN7GNR2HZE66S4D31EP8","quality-manager-qms-iso13485","ISO 13485 Quality Management System implementation and maintenance for medical device organizations. Provides QMS design, documentation control, internal auditing, CAPA management, and certification support. Use when working with medical device quality systems, preparing for ISO 13485 audits, managing regulatory compliance documentation, setting up corrective actions, or building audit preparation programs. Useful for quality management, audit preparation, regulatory compliance, medical device documentation, and corrective action workflows.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Fquality-manager-qms-iso13485\u002FSKILL.md",[217,220],{"categoryNo":218,"categoryName":219,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":221,"categoryName":222,"taxonomyType":223,"taxonomyTypeDesc":224},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[226,227,228,229,230,231,195,232,233,234,235,236,37,193,237,238,239,181,182,183],"quality manager qms iso13485","quality","design","review","support","workflows","audit","actions","compliance","system","process","up","maintenance","document",{"skillNo":241,"name":242,"nameZh":6,"description":243,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":244,"categories":245,"keywords":249,"publishedAt":44},"01M6DSNE5PQM106PM4EDGPBWGZ","quality-manager-qmr","Senior Quality Manager Responsible Person (QMR) for HealthTech and MedTech companies. Provides quality system governance, management review leadership, regulatory compliance oversight, and quality performance monitoring per ISO 13485 Clause 5.5.2.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Fquality-manager-qmr\u002FSKILL.md",[246],{"categoryNo":247,"categoryName":248,"taxonomyType":223,"taxonomyTypeDesc":224},"01JBSEEDCAT000000000000037","律师与法务",[250,227,229,251,252,253,254,234,255,235,168,256,193,257,258,259,182],"quality manager qmr","policy","performance","governance","monitoring","regulatory compliance","oversight","cost","culture","leadership",{"skillNo":261,"name":262,"nameZh":6,"description":263,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":264,"categories":265,"keywords":270,"publishedAt":44},"01M6DSN7MYXB6X42TB1GH2TNSB","quality-documentation-manager","Document control system management for medical device QMS. Covers document numbering, version control, change management, and 21 CFR Part 11 compliance. Use for document control procedures, change control workflow, document numbering, version management, electronic signature compliance, or regulatory documentation review.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Fquality-documentation-manager\u002FSKILL.md",[266,269],{"categoryNo":267,"categoryName":268,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理",{"categoryNo":247,"categoryName":248,"taxonomyType":223,"taxonomyTypeDesc":224},[195,271,227,229,272,273,232,175,274,235,275,276,37,277,278,279,183,280,281,282],"quality documentation manager","workflow","change","document lifecycle","change management","list","master","system management","documentation review","cfr","21 cfr part 11","change control",{"skillNo":284,"name":285,"nameZh":6,"description":286,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":287,"categories":288,"keywords":289,"publishedAt":44},"01M6DSN3R749H3R20K15QE8X8W","qms-audit-expert","ISO 13485 internal audit expertise for medical device QMS. Covers audit planning, execution, nonconformity classification, and CAPA verification. Use for internal audit planning, audit execution, finding classification, external audit preparation, or audit program management.","https:\u002F\u002Fgithub.com\u002Fzhangzhang-111-i\u002Fclaude-skills111\u002Fblob\u002Fmain\u002Fra-qm-team\u002Fqms-audit-expert\u002FSKILL.md",[],[232,290,291,198,292,293,294,295,168,37,296,180,182,183],"qms audit expert","expert","verification","execution","classification","schedule","checklist"]