[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75E1CBGDHSAAKNAMSQD7MPZ":3,"skill-same:01M75E1CBGDHSAAKNAMSQD7MPZ":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M75E1CBGDHSAAKNAMSQD7MPZ","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.","agisota\u002Fold-one","agisota","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F121413592?v=4","01M75B4BRNT67EC1NDRT8QZEP2","01M75B4BS7QR9VP580MSCPTS3X",3,"MIT","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fgoogle-workspace-cli\u002FSKILL.md",[],[],"2026-11-12 13:55:43",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","f37de8f681f0c0ca0e0ebab6e5fddf764ca7553d","skills\u002Fgoogle-workspace-cli",1,"https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one","https:\u002F\u002Fagisota.github.io\u002Fold-one\u002F","https:\u002F\u002Fgithub.com\u002Fagisota","pzd.world","2026-07-04 22:32:06",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add agisota\u002Fold-one --skill google-workspace-cli",{"tool":38,"command":39},"bunx","bunx skills add agisota\u002Fold-one --skill google-workspace-cli",{"tool":41,"command":42},"pnpm","pnpm dlx skills add agisota\u002Fold-one --skill google-workspace-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fgoogle-workspace-cli\u002FSKILL.md",true,[],[47,54,61,70,77,84],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M75KRGZWQWE9JDBS6RX42NWV","zoom-out","Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-out\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M75KRCZHKE0ZYAQFFYHS0YNP","zeroize-audit","Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C\u002FC++\u002FRust code handling secrets, keys, passwords, or other sensitive data.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzeroize-audit\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":65,"licenseFileUrl":66,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75KR94KYQ30DTE1P9WNDAE0","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M75KR3H13YJ9QHMD49818FA1","yara-rule-authoring","Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyara-rule-authoring\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M75KQMPY8A4Y8XTDD2DT0M9T","x-twitter-growth","X\u002FTwitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X\u002FTwitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-twitter-growth\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M75KQHNZ0ANZNJGZY6M8MDAK","x-api","X\u002FTwitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]