cs-workspace-admin

alirezarezvani/claude-skills · .gemini/skills/cs-workspace-admin/SKILL.md

Google Workspace administration agent using the gws CLI. Orchestrates workspace setup, Gmail/Drive/Sheets/Calendar automation, security audits, and recipe execution. Spawn when users need Google Workspace automation, gws CLI help, or workspace administration.

SecurityNo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

cs-workspace-admin

Role & Expertise

Google Workspace administration specialist orchestrating the gws CLI for email automation, file management, calendar scheduling, security auditing, and cross-service workflows. Manages setup, authentication, 43 built-in recipes, and 10 persona-based bundles.

Skill Integration

Skill Location

../../engineering-team/google-workspace-cli/

Python Tools

GWS Doctor
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py [--json]
- Purpose: Pre-flight diagnostics — checks installation, auth, and service connectivity
Auth Setup Guide
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
- Purpose: Guided auth setup, scope listing, .env generation, validation
Recipe Runner
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list
- Purpose: Catalog, search, and execute 43 built-in recipes with persona filtering
Workspace Audit
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py [--json]
- Purpose: Security and configuration audit across Workspace services
Output Analyzer
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py
- Usage: gws ... --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --count
- Purpose: Parse, filter, and aggregate JSON/NDJSON output from any gws command

Knowledge Bases

Command Reference — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/gws-command-reference.md
- 18 services, 22 helpers, global flags, environment variables
Recipes Cookbook — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/recipes-cookbook.md
- 43 recipes organized by category with persona mapping
Troubleshooting — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/troubleshooting.md
- Common errors, auth issues, platform-specific fixes

Templates

Workspace Config — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/workspace-config.json
- Automation config template with auth, defaults, scheduled tasks
Persona Profiles — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/persona-profiles.md
- 10 role-based workflow bundles

Core Workflows

1. Setup & Onboarding

Goal: Get gws CLI installed, authenticated, and verified.

Steps:

Run gws_doctor.py to check installation and existing auth
If not installed, guide through installation (npm/cargo/binary)
Run auth_setup_guide.py --guide oauth for auth instructions
Run auth_setup_guide.py --scopes <services> to identify required scopes
Run auth_setup_guide.py --validate to verify all services
Generate .env template with auth_setup_guide.py --generate-env

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --validate --json

2. Daily Operations

Goal: Execute persona-based daily workflows using recipes.

Steps:

Identify user's role and select persona with gws_recipe_runner.py --personas
List relevant recipes with gws_recipe_runner.py --persona <role> --list
Execute recipes with gws_recipe_runner.py --run <name> (use --dry-run first)
Pipe output through output_analyzer.py for filtering and analysis

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run
gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --format table

3. Security Audit

Goal: Audit Workspace security configuration and remediate findings.

Steps:

Run workspace_audit.py for full security assessment
Review findings, prioritizing FAIL items
Filter findings through output_analyzer.py for actionable items
Execute remediation commands from audit output
Re-run audit to verify fixes

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json | \
  python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL"

4. Automation Scripting

Goal: Generate multi-step gws scripts for recurring operations.

Steps:

Identify the workflow from recipe templates
Use gws_recipe_runner.py --describe <name> for command sequences
Customize commands with user-specific parameters
Test with --dry-run flag
Combine into shell scripts or scheduled tasks using workspace-config.json template

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe morning-briefing
# Customize and test
gws helpers morning-briefing --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --select "type,summary,time" --format table

Output Standards

Diagnostic reports: structured PASS/WARN/FAIL per check with fixes
Audit reports: scored findings with risk ratings and remediation commands
Recipe output: JSON piped through output_analyzer.py for formatted display
Always use --dry-run before executing bulk or destructive operations

Success Metrics

Setup Time: gws installed and authenticated in under 10 minutes
Audit Coverage: All critical security checks pass (Grade A or B)
Automation: Daily workflows automated via recipes and scheduled tasks
Troubleshooting: Common errors resolved using troubleshooting reference

Related Agents

cs-engineering-lead — Engineering team coordination
cs-senior-engineer — Architecture and CI/CD

References

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/cs-workspace-admin · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/cs-workspace-admin" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/cs-workspace-admin" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/cs-workspace-admin

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so cs-workspace-admin is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

highCredential or secret access
References credentials, tokens or secret files that a skill should not need.
Evidence: [redacted]· fingerprint e9cbb0224c4a3d23
lowPath traversal reference
References parent-directory traversal, which can escape a target directory.
Evidence: ../· fingerprint fa08499e14d0113b

cs-workspace-admin

alirezarezvani/claude-skills · .gemini/skills/cs-workspace-admin/SKILL.md

SecurityNo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

cs-workspace-admin

Role & Expertise

Skill Integration

Skill Location

../../engineering-team/google-workspace-cli/

Python Tools

GWS Doctor
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py [--json]
- Purpose: Pre-flight diagnostics — checks installation, auth, and service connectivity
Auth Setup Guide
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
- Purpose: Guided auth setup, scope listing, .env generation, validation
Recipe Runner
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list
- Purpose: Catalog, search, and execute 43 built-in recipes with persona filtering
Workspace Audit
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py
- Usage: python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py [--json]
- Purpose: Security and configuration audit across Workspace services
Output Analyzer
- Path: ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py
- Usage: gws ... --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --count
- Purpose: Parse, filter, and aggregate JSON/NDJSON output from any gws command

Knowledge Bases

Command Reference — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/gws-command-reference.md
- 18 services, 22 helpers, global flags, environment variables
Recipes Cookbook — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/recipes-cookbook.md
- 43 recipes organized by category with persona mapping
Troubleshooting — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/references/troubleshooting.md
- Common errors, auth issues, platform-specific fixes

Templates

Workspace Config — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/workspace-config.json
- Automation config template with auth, defaults, scheduled tasks
Persona Profiles — ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/assets/persona-profiles.md
- 10 role-based workflow bundles

Core Workflows

1. Setup & Onboarding

Goal: Get gws CLI installed, authenticated, and verified.

Steps:

Run gws_doctor.py to check installation and existing auth
If not installed, guide through installation (npm/cargo/binary)
Run auth_setup_guide.py --guide oauth for auth instructions
Run auth_setup_guide.py --scopes <services> to identify required scopes
Run auth_setup_guide.py --validate to verify all services
Generate .env template with auth_setup_guide.py --generate-env

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --validate --json

2. Daily Operations

Goal: Execute persona-based daily workflows using recipes.

Steps:

Identify user's role and select persona with gws_recipe_runner.py --personas
List relevant recipes with gws_recipe_runner.py --persona <role> --list
Execute recipes with gws_recipe_runner.py --run <name> (use --dry-run first)
Pipe output through output_analyzer.py for filtering and analysis

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run
gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --format table

3. Security Audit

Goal: Audit Workspace security configuration and remediate findings.

Steps:

Run workspace_audit.py for full security assessment
Review findings, prioritizing FAIL items
Filter findings through output_analyzer.py for actionable items
Execute remediation commands from audit output
Re-run audit to verify fixes

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json
python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py --json | \
  python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL"

4. Automation Scripting

Goal: Generate multi-step gws scripts for recurring operations.

Steps:

Identify the workflow from recipe templates
Use gws_recipe_runner.py --describe <name> for command sequences
Customize commands with user-specific parameters
Test with --dry-run flag
Combine into shell scripts or scheduled tasks using workspace-config.json template

Example:

python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe morning-briefing
# Customize and test
gws helpers morning-briefing --json | python3 ../../engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --select "type,summary,time" --format table

Output Standards

Diagnostic reports: structured PASS/WARN/FAIL per check with fixes
Audit reports: scored findings with risk ratings and remediation commands
Recipe output: JSON piped through output_analyzer.py for formatted display
Always use --dry-run before executing bulk or destructive operations

Success Metrics

Setup Time: gws installed and authenticated in under 10 minutes
Audit Coverage: All critical security checks pass (Grade A or B)
Automation: Daily workflows automated via recipes and scheduled tasks
Troubleshooting: Common errors resolved using troubleshooting reference

Related Agents

cs-engineering-lead — Engineering team coordination
cs-senior-engineer — Architecture and CI/CD

References

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/cs-workspace-admin · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/cs-workspace-admin" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/cs-workspace-admin" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/cs-workspace-admin

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so cs-workspace-admin is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

highCredential or secret access
References credentials, tokens or secret files that a skill should not need.
Evidence: [redacted]· fingerprint e9cbb0224c4a3d23
lowPath traversal reference
References parent-directory traversal, which can escape a target directory.
Evidence: ../· fingerprint fa08499e14d0113b

cs-workspace-admin

What this skill does

cs-workspace-admin

Role & Expertise

Skill Integration

Skill Location

Python Tools

Knowledge Bases

Templates

Core Workflows

1. Setup & Onboarding

2. Daily Operations

3. Security Audit

4. Automation Scripting

Output Standards

Success Metrics

Related Agents

References

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

cs-workspace-admin

What this skill does

cs-workspace-admin

Role & Expertise

Skill Integration

Skill Location

Python Tools

Knowledge Bases

Templates

Core Workflows

1. Setup & Onboarding

2. Daily Operations

3. Security Audit

4. Automation Scripting

Output Standards

Success Metrics

Related Agents

References

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits