google-workspace-cli
Offline audit of an exported Google Workspace config: 2SV, passwords, sharing, apps, admins, email DNS. Writes API auth setup guides
Install / Use
npx skills add borghei/Claude-Skills --skill google-workspace-cliInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of google-workspace-cli
google-workspace-cli scores 89/100 on our quality scale, 556th of 1,096 Security skills we index.
Its SKILL.md is 6.1 KB long, well organised into 25 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 817 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so google-workspace-cli is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
google-workspace-cli compared with similar skills
All 4 of these similar skills score higher than google-workspace-cli; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| google-workspace-cli (this skill)by borghei | 89 | 817 | 57d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP Server |
Frequently asked questions
- How do I install google-workspace-cli?
- Run
npx skills add borghei/Claude-Skills --skill google-workspace-cli. The install tabs above show the steps for each supported agent. - Which AI agents does google-workspace-cli work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is google-workspace-cli safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is google-workspace-cli still maintained?
- The repository was last updated about 2 months ago, so google-workspace-cli is actively maintained.
Skill content
View source on GitHubname: google-workspace-cli description: > This skill should be used when the user asks to "audit Google Workspace", "check GWS security settings", "set up Google Workspace authentication", "diagnose Workspace issues", or "review Google admin configurations". license: MIT + Commons Clause metadata: version: 1.0.0 author: borghei category: engineering domain: google-workspace updated: 2026-04-02 tags: [google-workspace, gws, admin, security, audit]
Google Workspace CLI
Category: Engineering Domain: Google Workspace Administration
Overview
The Google Workspace CLI skill provides tools for auditing Google Workspace configurations, generating authentication setup documentation, and diagnosing common GWS issues. It helps IT administrators maintain secure, well-configured Workspace environments without needing to navigate complex admin consoles.
Clarify First
Before running, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- [ ] Task — security audit, auth setup guide, or diagnostics (selects
workspace_audit.pyvsauth_setup_guide.pyvsgws_doctor.py) - [ ] Config export or auth method — the GWS config JSON to audit, or the auth method and scopes for a setup guide (sets
--configor--method/--scopes) - [ ] Output mode — human-readable vs JSON for automation (sets
--format json)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
# Audit Workspace security configuration
python scripts/workspace_audit.py --config gws-config.json
# Generate auth setup guide
python scripts/auth_setup_guide.py --method oauth --scopes admin,drive
# Run diagnostics
python scripts/gws_doctor.py --check all
# JSON output for automation
python scripts/workspace_audit.py --config gws-config.json --format json
Tools Overview
workspace_audit.py
Audits Google Workspace configuration exports for security best practices.
| Feature | Description | |---------|-------------| | 2FA enforcement | Checks if 2-step verification is required | | Password policy | Validates password strength requirements | | Sharing settings | Reviews external sharing configurations | | App access | Checks third-party app access policies | | Admin roles | Reviews admin role assignments | | Mobile management | Checks device management policies | | Drive settings | Validates Drive sharing and access controls |
auth_setup_guide.py
Generates step-by-step authentication setup documentation for GWS API access.
| Feature | Description | |---------|-------------| | OAuth setup | Generates OAuth 2.0 configuration guide | | Service account | Creates service account setup documentation | | API scopes | Lists required scopes for each API | | Domain delegation | Documents domain-wide delegation setup | | Testing guide | Provides verification steps |
gws_doctor.py
Diagnostic tool for common Google Workspace configuration issues.
| Feature | Description | |---------|-------------| | DNS checks | Validates MX, SPF, DKIM, DMARC records format | | SSL/TLS | Checks certificate and transport security settings | | Integration health | Validates common integration patterns | | Config consistency | Checks for conflicting settings | | Best practices | Compares against GWS recommended settings |
Workflows
Security Audit Workflow
- Export config - Export GWS settings to JSON via Admin SDK or manual export
- Audit - Run workspace_audit.py against the config file
- Review findings - Prioritize critical security gaps
- Remediate - Apply recommended settings in Admin Console
- Re-audit - Verify changes resolved findings
API Setup Workflow
- Plan - Determine which APIs and scopes are needed
- Generate guide - Run auth_setup_guide.py with desired method
- Follow steps - Create credentials in Google Cloud Console
- Configure - Set up domain delegation if needed
- Verify - Test API access with provided verification steps
Health Check Workflow
- Run diagnostics - Execute gws_doctor.py with all checks
- Review results - Check DNS, email, and integration health
- Fix issues - Address failures in priority order
- Re-check - Verify fixes pass diagnostics
Regular Maintenance
# Monthly security audit
python scripts/workspace_audit.py --config gws-export.json --format json > audit_$(date +%Y%m).json
# Weekly health check
python scripts/gws_doctor.py --check dns,email --format json
Reference Documentation
- GWS Admin Guide - Security settings, API configuration, DNS requirements
Common Patterns Quick Reference
Security Priorities
| Setting | Priority | Impact | |---------|----------|--------| | 2FA enforcement | Critical | Prevents account takeover | | Password policy | Critical | Reduces credential attacks | | External sharing | High | Prevents data leakage | | App access control | High | Limits third-party risk | | Mobile management | Medium | Secures device access | | Admin role review | Medium | Limits privilege exposure |
DNS Records for Email
| Record | Purpose | Example |
|--------|---------|---------|
| MX | Email routing | ASPMX.L.GOOGLE.COM |
| SPF | Sender verification | v=spf1 include:_spf.google.com ~all |
| DKIM | Email signing | Domain-specific CNAME |
| DMARC | Policy enforcement | v=DMARC1; p=reject; rua=mailto:... |
API Scopes
| API | Scope | Purpose |
|-----|-------|---------|
| Admin SDK | admin.directory.user | User management |
| Drive | drive.readonly | File listing |
| Gmail | gmail.settings.basic | Email settings |
| Calendar | calendar.readonly | Calendar access |
Common Issues
| Issue | Symptom | Fix | |-------|---------|-----| | No 2FA | Account takeover risk | Enable 2FA enforcement | | Weak passwords | Credential stuffing | Set 12+ char minimum | | Open sharing | Data leakage | Restrict external sharing | | No DMARC | Email spoofing | Add DMARC DNS record | | Stale admins | Excessive privileges | Review admin roles quarterly |
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
