From 4e9f1d934d8f4130c9343f480944e91343dae1f7 Mon Sep 17 00:00:00 2001 From: Reza Rezvani Date: Wed, 11 Mar 2026 09:59:40 +0100 Subject: [PATCH] feat(engineering): add google-workspace-cli skill with 5 Python tools New skill for Google Workspace administration via the gws CLI: - SKILL.md with 4 workflows (Gmail, Drive/Sheets, Calendar, Security Audit) - 5 stdlib-only Python scripts (doctor, auth setup, recipe runner, audit, analyzer) - 3 reference docs, 2 asset files, 43 built-in recipes, 10 persona bundles - cs-workspace-admin agent, /google-workspace slash command - Standalone marketplace plugin entry with .claude-plugin/plugin.json - Cross-platform sync (Codex CLI, Gemini CLI), MkDocs docs pages - All documentation updated (173 skills, 250 tools, 15 agents, 15 commands) Co-Authored-By: Claude Opus 4.6 --- .claude-plugin/marketplace.json | 32 +- .codex/skills-index.json | 10 +- .codex/skills/google-workspace-cli | 1 + .gemini/skills-index.json | 23 +- .gemini/skills/cs-workspace-admin/SKILL.md | 1 + .gemini/skills/google-workspace-cli/SKILL.md | 1 + .gemini/skills/google-workspace/SKILL.md | 1 + CLAUDE.md | 16 +- README.md | 16 +- agents/CLAUDE.md | 5 +- agents/engineering-team/cs-workspace-admin.md | 160 +++++++ commands/google-workspace.md | 77 ++++ docs/agents/cs-workspace-admin.md | 163 +++++++ docs/agents/index.md | 5 +- docs/commands/google-workspace.md | 84 ++++ docs/commands/index.md | 5 +- docs/getting-started.md | 4 +- docs/index.md | 14 +- .../engineering-team/google-workspace-cli.md | 380 +++++++++++++++++ docs/skills/engineering-team/index.md | 3 +- engineering-team/.claude-plugin/plugin.json | 2 +- engineering-team/CLAUDE.md | 10 +- .../.claude-plugin/plugin.json | 12 + .../google-workspace-cli/.gitignore | 14 + .../google-workspace-cli/SKILL.md | 373 ++++++++++++++++ .../assets/persona-profiles.md | 223 ++++++++++ .../assets/workspace-config.json | 61 +++ .../references/gws-command-reference.md | 313 ++++++++++++++ .../references/recipes-cookbook.md | 344 +++++++++++++++ .../references/troubleshooting.md | 323 ++++++++++++++ .../scripts/auth_setup_guide.py | 390 +++++++++++++++++ .../scripts/gws_doctor.py | 245 +++++++++++ .../scripts/gws_recipe_runner.py | 399 ++++++++++++++++++ .../scripts/output_analyzer.py | 332 +++++++++++++++ .../scripts/workspace_audit.py | 309 ++++++++++++++ mkdocs.yml | 5 +- 36 files changed, 4307 insertions(+), 49 deletions(-) create mode 120000 .codex/skills/google-workspace-cli create mode 120000 .gemini/skills/cs-workspace-admin/SKILL.md create mode 120000 .gemini/skills/google-workspace-cli/SKILL.md create mode 120000 .gemini/skills/google-workspace/SKILL.md create mode 100644 agents/engineering-team/cs-workspace-admin.md create mode 100644 commands/google-workspace.md create mode 100644 docs/agents/cs-workspace-admin.md create mode 100644 docs/commands/google-workspace.md create mode 100644 docs/skills/engineering-team/google-workspace-cli.md create mode 100644 engineering-team/google-workspace-cli/.claude-plugin/plugin.json create mode 100644 engineering-team/google-workspace-cli/.gitignore create mode 100644 engineering-team/google-workspace-cli/SKILL.md create mode 100644 engineering-team/google-workspace-cli/assets/persona-profiles.md create mode 100644 engineering-team/google-workspace-cli/assets/workspace-config.json create mode 100644 engineering-team/google-workspace-cli/references/gws-command-reference.md create mode 100644 engineering-team/google-workspace-cli/references/recipes-cookbook.md create mode 100644 engineering-team/google-workspace-cli/references/troubleshooting.md create mode 100644 engineering-team/google-workspace-cli/scripts/auth_setup_guide.py create mode 100644 engineering-team/google-workspace-cli/scripts/gws_doctor.py create mode 100644 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py create mode 100644 engineering-team/google-workspace-cli/scripts/output_analyzer.py create mode 100644 engineering-team/google-workspace-cli/scripts/workspace_audit.py diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index a75987c..6443fb3 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -4,11 +4,11 @@ "name": "Alireza Rezvani", "url": "https://alirezarezvani.com" }, - "description": "151 production-ready skill packages for Claude AI across 9 domains: marketing (43), engineering (23+25), C-level advisory (28), regulatory/QMS (12), product (8), project management (6), business growth (4), and finance (2). Includes 245 Python tools, 344 reference documents, 14 agents, and 14 slash commands.", + "description": "173 production-ready skill packages for Claude AI across 9 domains: marketing (43), engineering (24+25), C-level advisory (28), regulatory/QMS (12), product (8), project management (6), business growth (4), and finance (2). Includes 250 Python tools, 347 reference documents, 15 agents, and 15 slash commands.", "homepage": "https://github.com/alirezarezvani/claude-skills", "repository": "https://github.com/alirezarezvani/claude-skills", "metadata": { - "description": "151 production-ready skill packages across 9 domains with 245 Python tools, 344 reference documents, 14 agents, and 14 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.", + "description": "173 production-ready skill packages across 9 domains with 250 Python tools, 347 reference documents, 15 agents, and 15 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.", "version": "2.1.2" }, "plugins": [ @@ -82,7 +82,7 @@ { "name": "engineering-skills", "source": "./engineering-team", - "description": "23 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, tech stack evaluator.", + "description": "24 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, tech stack evaluator, Google Workspace CLI.", "version": "2.1.2", "author": { "name": "Alireza Rezvani" @@ -97,7 +97,12 @@ "ai", "ml", "data", - "playwright" + "playwright", + "google-workspace", + "gws", + "gmail", + "google-drive", + "google-sheets" ], "category": "development" }, @@ -345,6 +350,25 @@ "scanner" ], "category": "development" + }, + { + "name": "google-workspace-cli", + "source": "./engineering-team/google-workspace-cli", + "description": "Google Workspace administration via the gws CLI. Install, authenticate, and automate Gmail, Drive, Sheets, Calendar, Docs, Chat, and Tasks. 5 Python tools, 3 reference guides, 43 built-in recipes, 10 persona bundles.", + "version": "2.1.2", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "google-workspace", + "gws", + "gmail", + "google-drive", + "google-sheets", + "google-calendar", + "workspace-admin" + ], + "category": "development" } ] } diff --git a/.codex/skills-index.json b/.codex/skills-index.json index f2ec228..5ffdd16 100644 --- a/.codex/skills-index.json +++ b/.codex/skills-index.json @@ -3,7 +3,7 @@ "name": "claude-code-skills", "description": "Production-ready skill packages for AI agents - Marketing, Engineering, Product, C-Level, PM, and RA/QM", "repository": "https://github.com/alirezarezvani/claude-skills", - "total_skills": 151, + "total_skills": 152, "skills": [ { "name": "contract-and-proposal-writer", @@ -215,6 +215,12 @@ "category": "engineering", "description": "Email Template Builder" }, + { + "name": "google-workspace-cli", + "source": "../../engineering-team/google-workspace-cli", + "category": "engineering", + "description": "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." + }, { "name": "incident-commander", "source": "../../engineering-team/incident-commander", @@ -924,7 +930,7 @@ "description": "Executive leadership and advisory skills" }, "engineering": { - "count": 23, + "count": 24, "source": "../../engineering-team", "description": "Software engineering and technical skills" }, diff --git a/.codex/skills/google-workspace-cli b/.codex/skills/google-workspace-cli new file mode 120000 index 0000000..f728d97 --- /dev/null +++ b/.codex/skills/google-workspace-cli @@ -0,0 +1 @@ +../../engineering-team/google-workspace-cli \ No newline at end of file diff --git a/.gemini/skills-index.json b/.gemini/skills-index.json index 58dbafd..e350747 100644 --- a/.gemini/skills-index.json +++ b/.gemini/skills-index.json @@ -1,7 +1,7 @@ { "version": "1.0.0", "name": "gemini-cli-skills", - "total_skills": 208, + "total_skills": 211, "skills": [ { "name": "cs-agile-product-owner", @@ -73,6 +73,11 @@ "category": "agent", "description": "UX research agent for research planning, persona generation, journey mapping, and usability test analysis" }, + { + "name": "cs-workspace-admin", + "category": "agent", + "description": "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." + }, { "name": "business-growth-bundle", "category": "business-growth", @@ -283,6 +288,11 @@ "category": "command", "description": "Run financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecasts. Usage: /financial-health " }, + { + "name": "google-workspace", + "category": "command", + "description": "Google Workspace CLI operations: setup diagnostics, security audit, recipe discovery, and output analysis. Usage: /google-workspace [options]" + }, { "name": "okr", "category": "command", @@ -383,6 +393,11 @@ "category": "engineering", "description": ">-" }, + { + "name": "google-workspace-cli", + "category": "engineering", + "description": "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." + }, { "name": "incident-commander", "category": "engineering", @@ -1046,7 +1061,7 @@ ], "categories": { "agent": { - "count": 14, + "count": 15, "description": "Agent resources" }, "business-growth": { @@ -1058,11 +1073,11 @@ "description": "C-level resources" }, "command": { - "count": 14, + "count": 15, "description": "Command resources" }, "engineering": { - "count": 38, + "count": 39, "description": "Engineering resources" }, "engineering-advanced": { diff --git a/.gemini/skills/cs-workspace-admin/SKILL.md b/.gemini/skills/cs-workspace-admin/SKILL.md new file mode 120000 index 0000000..5a13ae4 --- /dev/null +++ b/.gemini/skills/cs-workspace-admin/SKILL.md @@ -0,0 +1 @@ +../../../agents/engineering-team/cs-workspace-admin.md \ No newline at end of file diff --git a/.gemini/skills/google-workspace-cli/SKILL.md b/.gemini/skills/google-workspace-cli/SKILL.md new file mode 120000 index 0000000..fcadf8e --- /dev/null +++ b/.gemini/skills/google-workspace-cli/SKILL.md @@ -0,0 +1 @@ +../../../engineering-team/google-workspace-cli/SKILL.md \ No newline at end of file diff --git a/.gemini/skills/google-workspace/SKILL.md b/.gemini/skills/google-workspace/SKILL.md new file mode 120000 index 0000000..dfe2e2c --- /dev/null +++ b/.gemini/skills/google-workspace/SKILL.md @@ -0,0 +1 @@ +../../../commands/google-workspace.md \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md index 5523fd6..f1d8708 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co This is a **comprehensive skills library** for Claude AI and Claude Code - reusable, production-ready skill packages that bundle domain expertise, best practices, analysis tools, and strategic frameworks. The repository provides modular skills that teams can download and use directly in their workflows. -**Current Scope:** 172 production-ready skills across 9 domains with 245 Python automation tools, 344 reference guides, 14 agents, and 14 slash commands. +**Current Scope:** 173 production-ready skills across 9 domains with 250 Python automation tools, 347 reference guides, 15 agents, and 15 slash commands. **Key Distinction**: This is NOT a traditional application. It's a library of skill packages meant to be extracted and deployed by users into their own Claude workflows. @@ -36,9 +36,9 @@ This repository uses **modular documentation**. For domain-specific guidance, se ``` claude-code-skills/ ├── .claude-plugin/ # Plugin registry (marketplace.json) -├── agents/ # 14 cs-* prefixed agents across all domains -├── commands/ # 14 slash commands (changelog, tdd, saas-health, etc.) -├── engineering-team/ # 23 core engineering skills + Playwright Pro + Self-Improving Agent +├── agents/ # 15 cs-* prefixed agents across all domains +├── commands/ # 15 slash commands (changelog, tdd, saas-health, workspace, etc.) +├── engineering-team/ # 24 core engineering skills + Playwright Pro + Self-Improving Agent ├── engineering/ # 25 POWERFUL-tier advanced skills ├── product-team/ # 8 product skills + Python tools ├── marketing-skill/ # 43 marketing skills (7 pods) + Python tools @@ -148,9 +148,9 @@ See [standards/git/git-workflow-standards.md](standards/git/git-workflow-standar ## Roadmap -**Phase 1-2 Complete:** 172 production-ready skills deployed across 9 domains -- Engineering Core (23), Engineering POWERFUL (25), Product (8), Marketing (42), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2) -- 245 Python automation tools, 344 reference guides, 14 agents, 14 commands +**Phase 1-2 Complete:** 173 production-ready skills deployed across 9 domains +- Engineering Core (24), Engineering POWERFUL (25), Product (8), Marketing (42), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2) +- 250 Python automation tools, 347 reference guides, 15 agents, 15 commands - Complete enterprise coverage from engineering through regulatory compliance, sales, customer success, and finance - MkDocs Material docs site with 206 indexed pages for SEO @@ -203,4 +203,4 @@ This repository publishes skills to **ClawHub** (clawhub.com) as the distributio **Last Updated:** March 10, 2026 **Version:** v2.1.2 -**Status:** 172 skills deployed across 9 domains, 19 marketplace plugins, docs site live +**Status:** 173 skills deployed across 9 domains, 19 marketplace plugins, docs site live diff --git a/README.md b/README.md index 566f47a..1ae6de5 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ # Claude Code Skills & Plugins -**172 production-ready skills and plugins for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw** — reusable expertise bundles that transform AI coding agents into specialized professionals across engineering, product, marketing, compliance, and more. +**173 production-ready skills and plugins for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw** — reusable expertise bundles that transform AI coding agents into specialized professionals across engineering, product, marketing, compliance, and more. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![Skills](https://img.shields.io/badge/Skills-172-brightgreen.svg)](#skills-overview) -[![Agents](https://img.shields.io/badge/Agents-14-blue.svg)](#agents) -[![Commands](https://img.shields.io/badge/Commands-14-orange.svg)](#commands) +[![Skills](https://img.shields.io/badge/Skills-173-brightgreen.svg)](#skills-overview) +[![Agents](https://img.shields.io/badge/Agents-15-blue.svg)](#agents) +[![Commands](https://img.shields.io/badge/Commands-15-orange.svg)](#commands) [![Stars](https://img.shields.io/github/stars/alirezarezvani/claude-skills?style=flat)](https://github.com/alirezarezvani/claude-skills/stargazers) [![SkillCheck Validated](https://img.shields.io/badge/SkillCheck-Validated-4c1)](https://getskillcheck.com) @@ -17,7 +17,7 @@ Skills are modular instruction packages (plugins) that give AI coding agents domain expertise they don't have out of the box. Each skill includes a `SKILL.md` (instructions + workflows), Python CLI tools, and reference documentation — everything the agent needs to perform like a specialist. -**One repo, four platforms:** Works natively as Claude Code plugins, OpenAI Codex CLI and agents, Gemini CLI skills, and OpenClaw skills. All 237 Python tools are stdlib-only and verified working. +**One repo, four platforms:** Works natively as Claude Code plugins, OpenAI Codex CLI and agents, Gemini CLI skills, and OpenClaw skills. All 250 Python tools are stdlib-only and verified working. --- @@ -44,7 +44,7 @@ cd claude-skills /plugin marketplace add alirezarezvani/claude-skills # Install by domain -/plugin install engineering-skills@claude-code-skills # 23 core engineering +/plugin install engineering-skills@claude-code-skills # 24 core engineering /plugin install engineering-advanced-skills@claude-code-skills # 25 POWERFUL-tier /plugin install product-skills@claude-code-skills # 8 product skills /plugin install marketing-skills@claude-code-skills # 43 marketing skills @@ -85,11 +85,11 @@ git clone https://github.com/alirezarezvani/claude-skills.git ## Skills Overview -**172 skills across 9 domains:** +**173 skills across 9 domains:** | Domain | Skills | Highlights | Details | |--------|--------|------------|---------| -| **🔧 Engineering — Core** | 23 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent | [engineering-team/](engineering-team/) | +| **🔧 Engineering — Core** | 24 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent, Google Workspace CLI | [engineering-team/](engineering-team/) | | **🎭 Playwright Pro** | 9+3 | Test generation, flaky fix, Cypress/Selenium migration, TestRail, BrowserStack, 55 templates | [engineering-team/playwright-pro](engineering-team/playwright-pro/) | | **🧠 Self-Improving Agent** | 5+2 | Auto-memory curation, pattern promotion, skill extraction, memory health | [engineering-team/self-improving-agent](engineering-team/self-improving-agent/) | | **⚡ Engineering — POWERFUL** | 25 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder | [engineering/](engineering/) | diff --git a/agents/CLAUDE.md b/agents/CLAUDE.md index 9e8b4e9..a285a36 100644 --- a/agents/CLAUDE.md +++ b/agents/CLAUDE.md @@ -24,7 +24,7 @@ When skills are published to **ClawHub** (clawhub.com): ### Production Agents -**5 Agents Currently Available** (as of November 5, 2025): +**6 Agents Currently Available**: | Agent | Domain | Description | Skills Used | Lines | |-------|--------|-------------|-------------|-------| @@ -33,8 +33,9 @@ When skills are published to **ClawHub** (clawhub.com): | [cs-ceo-advisor](c-level/cs-ceo-advisor.md) | C-Level | Strategic leadership advisor for CEOs covering vision, strategy, board management | ceo-advisor | 360 | | [cs-cto-advisor](c-level/cs-cto-advisor.md) | C-Level | Technical leadership advisor for CTOs covering tech strategy and team scaling | cto-advisor | 412 | | [cs-product-manager](product/cs-product-manager.md) | Product | Product management agent for RICE prioritization and customer discovery | product-manager-toolkit | 407 | +| [cs-workspace-admin](engineering-team/cs-workspace-admin.md) | Engineering | Google Workspace administration via gws CLI — setup, automation, security audits, recipes | google-workspace-cli | 120 | -**Total**: 1,795 lines of comprehensive agent documentation +**Total**: ~1,915 lines of comprehensive agent documentation **Template Available**: [templates/agent-template.md](../templates/agent-template.md) (318 lines) - Use this to create new agents diff --git a/agents/engineering-team/cs-workspace-admin.md b/agents/engineering-team/cs-workspace-admin.md new file mode 100644 index 0000000..c0b9a5e --- /dev/null +++ b/agents/engineering-team/cs-workspace-admin.md @@ -0,0 +1,160 @@ +--- +name: cs-workspace-admin +description: 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. +skills: engineering-team/google-workspace-cli +domain: engineering +model: opus +tools: [Read, Write, Bash, Grep, Glob] +--- + +# 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 + +1. **GWS Doctor** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_doctor.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json]` + - **Purpose:** Pre-flight diagnostics — checks installation, auth, and service connectivity + +2. **Auth Setup Guide** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth` + - **Purpose:** Guided auth setup, scope listing, .env generation, validation + +3. **Recipe Runner** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list` + - **Purpose:** Catalog, search, and execute 43 built-in recipes with persona filtering + +4. **Workspace Audit** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/workspace_audit.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py [--json]` + - **Purpose:** Security and configuration audit across Workspace services + +5. **Output Analyzer** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/output_analyzer.py` + - **Usage:** `gws ... --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --count` + - **Purpose:** Parse, filter, and aggregate JSON/NDJSON output from any gws command + +### Knowledge Bases + +1. **Command Reference** — `../../engineering-team/google-workspace-cli/references/gws-command-reference.md` + - 18 services, 22 helpers, global flags, environment variables +2. **Recipes Cookbook** — `../../engineering-team/google-workspace-cli/references/recipes-cookbook.md` + - 43 recipes organized by category with persona mapping +3. **Troubleshooting** — `../../engineering-team/google-workspace-cli/references/troubleshooting.md` + - Common errors, auth issues, platform-specific fixes + +### Templates + +1. **Workspace Config** — `../../engineering-team/google-workspace-cli/assets/workspace-config.json` + - Automation config template with auth, defaults, scheduled tasks +2. **Persona Profiles** — `../../engineering-team/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:** +1. Run `gws_doctor.py` to check installation and existing auth +2. If not installed, guide through installation (npm/cargo/binary) +3. Run `auth_setup_guide.py --guide oauth` for auth instructions +4. Run `auth_setup_guide.py --scopes ` to identify required scopes +5. Run `auth_setup_guide.py --validate` to verify all services +6. Generate `.env` template with `auth_setup_guide.py --generate-env` + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py +python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth +python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate --json +``` + +### 2. Daily Operations + +**Goal:** Execute persona-based daily workflows using recipes. + +**Steps:** +1. Identify user's role and select persona with `gws_recipe_runner.py --personas` +2. List relevant recipes with `gws_recipe_runner.py --persona --list` +3. Execute recipes with `gws_recipe_runner.py --run ` (use `--dry-run` first) +4. Pipe output through `output_analyzer.py` for filtering and analysis + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list +python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run +gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --format table +``` + +### 3. Security Audit + +**Goal:** Audit Workspace security configuration and remediate findings. + +**Steps:** +1. Run `workspace_audit.py` for full security assessment +2. Review findings, prioritizing FAIL items +3. Filter findings through `output_analyzer.py` for actionable items +4. Execute remediation commands from audit output +5. Re-run audit to verify fixes + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json +python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json | \ + python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL" +``` + +### 4. Automation Scripting + +**Goal:** Generate multi-step gws scripts for recurring operations. + +**Steps:** +1. Identify the workflow from recipe templates +2. Use `gws_recipe_runner.py --describe ` for command sequences +3. Customize commands with user-specific parameters +4. Test with `--dry-run` flag +5. Combine into shell scripts or scheduled tasks using `workspace-config.json` template + +**Example:** +```bash +python3 ../../engineering-team/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/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](cs-engineering-lead.md) — Engineering team coordination +- [cs-senior-engineer](../engineering/cs-senior-engineer.md) — Architecture and CI/CD + +## References + +- [Skill Documentation](../../engineering-team/google-workspace-cli/SKILL.md) +- [gws CLI Repository](https://github.com/googleworkspace/cli) diff --git a/commands/google-workspace.md b/commands/google-workspace.md new file mode 100644 index 0000000..704ef5c --- /dev/null +++ b/commands/google-workspace.md @@ -0,0 +1,77 @@ +--- +name: google-workspace +description: "Google Workspace CLI operations: setup diagnostics, security audit, recipe discovery, and output analysis. Usage: /google-workspace [options]" +--- + +# /google-workspace + +Google Workspace CLI administration via the `gws` CLI. Run setup diagnostics, security audits, browse and execute recipes, and analyze command output. + +## Usage + +``` +/google-workspace setup [--json] +/google-workspace audit [--services gmail,drive,calendar] [--json] +/google-workspace recipe list [--persona ] [--json] +/google-workspace recipe search [--json] +/google-workspace recipe run [--dry-run] +/google-workspace recipe describe +/google-workspace analyze [--filter ] [--group-by ] [--stats ] [--format table|csv|json] +``` + +## Examples + +``` +/google-workspace setup +/google-workspace audit --services gmail,drive --json +/google-workspace recipe list --persona pm +/google-workspace recipe search "email" +/google-workspace recipe run standup-report --dry-run +/google-workspace recipe describe morning-briefing +/google-workspace analyze --filter "mimeType=pdf" --select "name,size" --format table +``` + +## Scripts + +- `engineering-team/google-workspace-cli/scripts/gws_doctor.py` — Pre-flight diagnostics +- `engineering-team/google-workspace-cli/scripts/auth_setup_guide.py` — Auth setup guide +- `engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py` — Recipe catalog & runner +- `engineering-team/google-workspace-cli/scripts/workspace_audit.py` — Security audit +- `engineering-team/google-workspace-cli/scripts/output_analyzer.py` — JSON/NDJSON analyzer + +## Subcommands + +### setup +Run pre-flight diagnostics and auth validation. +```bash +python3 engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json] +python3 engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate [--json] +``` + +### audit +Run security and configuration audit. +```bash +python3 engineering-team/google-workspace-cli/scripts/workspace_audit.py [--services gmail,drive,calendar] [--json] +``` + +### recipe +Browse, search, and execute the 43 built-in gws recipes. +```bash +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona ] [--json] +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --search [--json] +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --describe +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run [--dry-run] +``` + +### analyze +Parse, filter, and aggregate JSON output from any gws command. +```bash +gws --json | python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py [options] +python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py --demo --format table +``` + +## Skill Reference +-> `engineering-team/google-workspace-cli/SKILL.md` + +## Related Commands +- No direct dependencies (self-contained Google Workspace skill) diff --git a/docs/agents/cs-workspace-admin.md b/docs/agents/cs-workspace-admin.md new file mode 100644 index 0000000..f210907 --- /dev/null +++ b/docs/agents/cs-workspace-admin.md @@ -0,0 +1,163 @@ +--- +title: "cs-workspace-admin" +description: "cs-workspace-admin - Claude Code agent for Engineering - Core." +--- + +# cs-workspace-admin + +**Type:** Agent | **Domain:** Engineering - Core | **Source:** [`agents/engineering-team/cs-workspace-admin.md`](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering-team/cs-workspace-admin.md) + +--- + + +# 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 + +1. **GWS Doctor** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_doctor.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json]` + - **Purpose:** Pre-flight diagnostics — checks installation, auth, and service connectivity + +2. **Auth Setup Guide** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth` + - **Purpose:** Guided auth setup, scope listing, .env generation, validation + +3. **Recipe Runner** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list` + - **Purpose:** Catalog, search, and execute 43 built-in recipes with persona filtering + +4. **Workspace Audit** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/workspace_audit.py` + - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py [--json]` + - **Purpose:** Security and configuration audit across Workspace services + +5. **Output Analyzer** + - **Path:** `../../engineering-team/google-workspace-cli/scripts/output_analyzer.py` + - **Usage:** `gws ... --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --count` + - **Purpose:** Parse, filter, and aggregate JSON/NDJSON output from any gws command + +### Knowledge Bases + +1. **Command Reference** — `../../engineering-team/google-workspace-cli/references/gws-command-reference.md` + - 18 services, 22 helpers, global flags, environment variables +2. **Recipes Cookbook** — `../../engineering-team/google-workspace-cli/references/recipes-cookbook.md` + - 43 recipes organized by category with persona mapping +3. **Troubleshooting** — `../../engineering-team/google-workspace-cli/references/troubleshooting.md` + - Common errors, auth issues, platform-specific fixes + +### Templates + +1. **Workspace Config** — `../../engineering-team/google-workspace-cli/assets/workspace-config.json` + - Automation config template with auth, defaults, scheduled tasks +2. **Persona Profiles** — `../../engineering-team/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:** +1. Run `gws_doctor.py` to check installation and existing auth +2. If not installed, guide through installation (npm/cargo/binary) +3. Run `auth_setup_guide.py --guide oauth` for auth instructions +4. Run `auth_setup_guide.py --scopes ` to identify required scopes +5. Run `auth_setup_guide.py --validate` to verify all services +6. Generate `.env` template with `auth_setup_guide.py --generate-env` + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py +python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth +python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate --json +``` + +### 2. Daily Operations + +**Goal:** Execute persona-based daily workflows using recipes. + +**Steps:** +1. Identify user's role and select persona with `gws_recipe_runner.py --personas` +2. List relevant recipes with `gws_recipe_runner.py --persona --list` +3. Execute recipes with `gws_recipe_runner.py --run ` (use `--dry-run` first) +4. Pipe output through `output_analyzer.py` for filtering and analysis + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --persona pm --list +python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run standup-report --dry-run +gws recipes standup-report --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --format table +``` + +### 3. Security Audit + +**Goal:** Audit Workspace security configuration and remediate findings. + +**Steps:** +1. Run `workspace_audit.py` for full security assessment +2. Review findings, prioritizing FAIL items +3. Filter findings through `output_analyzer.py` for actionable items +4. Execute remediation commands from audit output +5. Re-run audit to verify fixes + +**Example:** +```bash +python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json +python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py --json | \ + python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --filter "status=FAIL" +``` + +### 4. Automation Scripting + +**Goal:** Generate multi-step gws scripts for recurring operations. + +**Steps:** +1. Identify the workflow from recipe templates +2. Use `gws_recipe_runner.py --describe ` for command sequences +3. Customize commands with user-specific parameters +4. Test with `--dry-run` flag +5. Combine into shell scripts or scheduled tasks using `workspace-config.json` template + +**Example:** +```bash +python3 ../../engineering-team/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/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](cs-engineering-lead.md) — Engineering team coordination +- [cs-senior-engineer](../engineering/cs-senior-engineer.md) — Architecture and CI/CD + +## References + +- [Skill Documentation](../../engineering-team/google-workspace-cli/SKILL.md) +- [gws CLI Repository](https://github.com/googleworkspace/cli) diff --git a/docs/agents/index.md b/docs/agents/index.md index 3d81816..99df23a 100644 --- a/docs/agents/index.md +++ b/docs/agents/index.md @@ -1,11 +1,11 @@ --- title: "Agents" -description: "All 14 Claude Code agents — multi-skill orchestrators across domains." +description: "All 15 Claude Code agents — multi-skill orchestrators across domains." --- # Agents -14 agents that orchestrate skills across domains. +15 agents that orchestrate skills across domains. | Agent | Domain | |-------|--------| @@ -14,6 +14,7 @@ description: "All 14 Claude Code agents — multi-skill orchestrators across dom | [CTO Advisor Agent](cs-cto-advisor.md) | C-Level Advisory | | [cs-senior-engineer](cs-senior-engineer.md) | Engineering - POWERFUL | | [cs-engineering-lead](cs-engineering-lead.md) | Engineering - Core | +| [cs-workspace-admin](cs-workspace-admin.md) | Engineering - Core | | [cs-financial-analyst](cs-financial-analyst.md) | Finance | | [Content Creator Agent](cs-content-creator.md) | Marketing | | [Demand Generation Specialist Agent](cs-demand-gen-specialist.md) | Marketing | diff --git a/docs/commands/google-workspace.md b/docs/commands/google-workspace.md new file mode 100644 index 0000000..9673339 --- /dev/null +++ b/docs/commands/google-workspace.md @@ -0,0 +1,84 @@ +--- +title: "/google-workspace" +description: "/google-workspace — Claude Code slash command." +--- + +# /google-workspace + +**Type:** Slash Command | **Source:** [`commands/google-workspace.md`](https://github.com/alirezarezvani/claude-skills/tree/main/commands/google-workspace.md) + +--- + + +# /google-workspace + +Google Workspace CLI administration via the `gws` CLI. Run setup diagnostics, security audits, browse and execute recipes, and analyze command output. + +## Usage + +``` +/google-workspace setup [--json] +/google-workspace audit [--services gmail,drive,calendar] [--json] +/google-workspace recipe list [--persona ] [--json] +/google-workspace recipe search [--json] +/google-workspace recipe run [--dry-run] +/google-workspace recipe describe +/google-workspace analyze [--filter ] [--group-by ] [--stats ] [--format table|csv|json] +``` + +## Examples + +``` +/google-workspace setup +/google-workspace audit --services gmail,drive --json +/google-workspace recipe list --persona pm +/google-workspace recipe search "email" +/google-workspace recipe run standup-report --dry-run +/google-workspace recipe describe morning-briefing +/google-workspace analyze --filter "mimeType=pdf" --select "name,size" --format table +``` + +## Scripts + +- `engineering-team/google-workspace-cli/scripts/gws_doctor.py` — Pre-flight diagnostics +- `engineering-team/google-workspace-cli/scripts/auth_setup_guide.py` — Auth setup guide +- `engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py` — Recipe catalog & runner +- `engineering-team/google-workspace-cli/scripts/workspace_audit.py` — Security audit +- `engineering-team/google-workspace-cli/scripts/output_analyzer.py` — JSON/NDJSON analyzer + +## Subcommands + +### setup +Run pre-flight diagnostics and auth validation. +```bash +python3 engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json] +python3 engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --validate [--json] +``` + +### audit +Run security and configuration audit. +```bash +python3 engineering-team/google-workspace-cli/scripts/workspace_audit.py [--services gmail,drive,calendar] [--json] +``` + +### recipe +Browse, search, and execute the 43 built-in gws recipes. +```bash +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona ] [--json] +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --search [--json] +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --describe +python3 engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --run [--dry-run] +``` + +### analyze +Parse, filter, and aggregate JSON output from any gws command. +```bash +gws --json | python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py [options] +python3 engineering-team/google-workspace-cli/scripts/output_analyzer.py --demo --format table +``` + +## Skill Reference +-> `engineering-team/google-workspace-cli/SKILL.md` + +## Related Commands +- No direct dependencies (self-contained Google Workspace skill) diff --git a/docs/commands/index.md b/docs/commands/index.md index 0f9e7c6..53e63ed 100644 --- a/docs/commands/index.md +++ b/docs/commands/index.md @@ -1,17 +1,18 @@ --- title: "Commands" -description: "All 14 slash commands for quick access to common operations." +description: "All 15 slash commands for quick access to common operations." --- # Slash Commands -14 commands for quick access to common operations. +15 commands for quick access to common operations. | Command | Description | |---------|-------------| | [`/changelog`](changelog.md) | Generate Keep a Changelog entries from git history and validate commit message format. | | [`/competitive-matrix`](competitive-matrix.md) | Build competitive matrices with weighted scoring, gap analysis, and market positioning insights. | | [`/financial-health`](financial-health.md) | Analyze financial statements, build valuation models, assess budget variances, and construct forecasts. | +| [`/google-workspace`](google-workspace.md) | Google Workspace CLI administration via the `gws` CLI. Run setup diagnostics, security audits, browse and execute recipes, and analyze command output. | | [`/okr`](okr.md) | Generate cascaded OKR frameworks from company-level strategy down to team-level key results. | | [`/persona`](persona.md) | Generate structured user personas with demographics, goals, pain points, and behavioral patterns. | | [`/pipeline`](pipeline.md) | Detect project stack and generate CI/CD pipeline configurations for GitHub Actions or GitLab CI. | diff --git a/docs/getting-started.md b/docs/getting-started.md index 93057c2..314ae23 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -70,7 +70,7 @@ Choose your platform and follow the steps: | Bundle | Install Command | Skills | |--------|----------------|--------| -| **Engineering Core** | `/plugin install engineering-skills@claude-code-skills` | 23 | +| **Engineering Core** | `/plugin install engineering-skills@claude-code-skills` | 24 | | **Engineering POWERFUL** | `/plugin install engineering-advanced-skills@claude-code-skills` | 25 | | **Product** | `/plugin install product-skills@claude-code-skills` | 8 | | **Marketing** | `/plugin install marketing-skills@claude-code-skills` | 43 | @@ -112,7 +112,7 @@ AI-augmented development. Optimize for SEO. ## Python Tools -All 245 tools use the standard library only — zero pip installs, all verified. +All 250 tools use the standard library only — zero pip installs, all verified. ```bash # Security audit a skill before installing diff --git a/docs/index.md b/docs/index.md index 5a657bc..e35f833 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,6 @@ --- title: Claude Code Skills & Plugins -description: "172 production-ready skills, 14 agents, and 14 commands for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw." +description: "173 production-ready skills, 15 agents, and 15 commands for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw." hide: - toc - edit @@ -14,7 +14,7 @@ hide: # Claude Code Skills -172 production-ready skills that transform AI coding agents into specialized professionals. +173 production-ready skills that transform AI coding agents into specialized professionals. { .hero-subtitle } **Claude Code** | **OpenAI Codex** | **Gemini CLI** | **OpenClaw** @@ -27,25 +27,25 @@ hide:
-- :material-counter:{ .lg .middle } **172** +- :material-counter:{ .lg .middle } **173** --- Production-ready skills -- :material-language-python:{ .lg .middle } **245** +- :material-language-python:{ .lg .middle } **250** --- Python CLI tools (stdlib-only, all verified) -- :material-robot:{ .lg .middle } **14** +- :material-robot:{ .lg .middle } **15** --- [Multi-skill agents](agents/) -- :material-console:{ .lg .middle } **14** +- :material-console:{ .lg .middle } **15** --- @@ -65,7 +65,7 @@ hide: Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data engineering, Playwright testing, self-improving agent - [:octicons-arrow-right-24: 23 skills](skills/engineering-team/) + [:octicons-arrow-right-24: 24 skills](skills/engineering-team/) - :material-lightning-bolt:{ .lg .middle } **Engineering — POWERFUL** diff --git a/docs/skills/engineering-team/google-workspace-cli.md b/docs/skills/engineering-team/google-workspace-cli.md new file mode 100644 index 0000000..0e24f3c --- /dev/null +++ b/docs/skills/engineering-team/google-workspace-cli.md @@ -0,0 +1,380 @@ +--- +title: "Google Workspace CLI" +description: "Google Workspace CLI - Claude Code skill from the Engineering - Core domain." +--- + +# Google Workspace CLI + +**Domain:** Engineering - Core | **Skill:** `google-workspace-cli` | **Source:** [`engineering-team/google-workspace-cli/SKILL.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/SKILL.md) + +--- + + +# Google Workspace CLI + +Expert 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. + +--- + +## Quick Start + +### Check Installation + +```bash +# Verify gws is installed and authenticated +python3 scripts/gws_doctor.py +``` + +### Send an Email + +```bash +gws gmail users.messages send me --to "team@company.com" \ + --subject "Weekly Update" --body "Here's this week's summary..." +``` + +### List Drive Files + +```bash +gws drive files list --json --limit 20 | python3 scripts/output_analyzer.py --select "name,mimeType,modifiedTime" --format table +``` + +--- + +## Installation + +### npm (recommended) + +```bash +npm install -g @anthropic/gws +gws --version +``` + +### Cargo (from source) + +```bash +cargo install gws-cli +gws --version +``` + +### Pre-built Binaries + +Download from [github.com/googleworkspace/cli/releases](https://github.com/googleworkspace/cli/releases) for macOS, Linux, or Windows. + +### Verify Installation + +```bash +python3 scripts/gws_doctor.py +# Checks: PATH, version, auth status, service connectivity +``` + +--- + +## Authentication + +### OAuth Setup (Interactive) + +```bash +# Step 1: Create Google Cloud project and OAuth credentials +python3 scripts/auth_setup_guide.py --guide oauth + +# Step 2: Run auth setup +gws auth setup + +# Step 3: Validate +gws auth status --json +``` + +### Service Account (Headless/CI) + +```bash +# Generate setup instructions +python3 scripts/auth_setup_guide.py --guide service-account + +# Configure with key file +export GWS_SERVICE_ACCOUNT_KEY=/path/to/key.json +export GWS_DELEGATED_USER=admin@company.com +gws auth status +``` + +### Environment Variables + +```bash +# Generate .env template +python3 scripts/auth_setup_guide.py --generate-env +``` + +| Variable | Purpose | +|----------|---------| +| `GWS_CLIENT_ID` | OAuth client ID | +| `GWS_CLIENT_SECRET` | OAuth client secret | +| `GWS_TOKEN_PATH` | Custom token storage path | +| `GWS_SERVICE_ACCOUNT_KEY` | Service account JSON key path | +| `GWS_DELEGATED_USER` | User to impersonate (service accounts) | +| `GWS_DEFAULT_FORMAT` | Default output format (json/ndjson/table) | + +### Validate Authentication + +```bash +python3 scripts/auth_setup_guide.py --validate --json +# Tests each service endpoint +``` + +--- + +## Workflow 1: Gmail Automation + +**Goal:** Automate email operations — send, search, label, and filter management. + +### Send and Reply + +```bash +# Send a new email +gws gmail users.messages send me --to "client@example.com" \ + --subject "Proposal" --body "Please find attached..." \ + --attachment proposal.pdf + +# Reply to a thread +gws gmail users.messages reply me --thread-id \ + --body "Thanks for your feedback..." + +# Forward a message +gws gmail users.messages forward me --message-id \ + --to "manager@company.com" +``` + +### Search and Filter + +```bash +# Search emails +gws gmail users.messages list me --query "from:client@example.com after:2025/01/01" --json \ + | python3 scripts/output_analyzer.py --count + +# List labels +gws gmail users.labels list me --json + +# Create a filter +gws gmail users.settings.filters create me \ + --criteria '{"from":"notifications@service.com"}' \ + --action '{"addLabelIds":["Label_123"],"removeLabelIds":["INBOX"]}' +``` + +### Bulk Operations + +```bash +# Archive all read emails older than 30 days +gws gmail users.messages list me --query "is:read older_than:30d" --json \ + | python3 scripts/output_analyzer.py --select "id" --format json \ + | xargs -I {} gws gmail users.messages modify me {} --removeLabelIds INBOX +``` + +--- + +## Workflow 2: Drive & Sheets + +**Goal:** Manage files, create spreadsheets, configure sharing, and export data. + +### File Operations + +```bash +# List files +gws drive files list --json --limit 50 \ + | python3 scripts/output_analyzer.py --select "name,mimeType,size" --format table + +# Upload a file +gws drive files create --name "Q1 Report" --upload report.pdf \ + --parents + +# Create a Google Sheet +gws sheets spreadsheets create --title "Budget 2026" --json + +# Download/export +gws drive files export --mime "application/pdf" --output report.pdf +``` + +### Sharing + +```bash +# Share with user +gws drive permissions create \ + --type user --role writer --emailAddress "colleague@company.com" + +# Share with domain (view only) +gws drive permissions create \ + --type domain --role reader --domain "company.com" + +# List who has access +gws drive permissions list --json +``` + +### Sheets Data + +```bash +# Read a range +gws sheets spreadsheets.values get --range "Sheet1!A1:D10" --json + +# Write data +gws sheets spreadsheets.values update --range "Sheet1!A1" \ + --values '[["Name","Score"],["Alice",95],["Bob",87]]' + +# Append rows +gws sheets spreadsheets.values append --range "Sheet1!A1" \ + --values '[["Charlie",92]]' +``` + +--- + +## Workflow 3: Calendar & Meetings + +**Goal:** Schedule events, find available times, and generate standup reports. + +### Event Management + +```bash +# Create an event +gws calendar events insert primary \ + --summary "Sprint Planning" \ + --start "2026-03-15T10:00:00" --end "2026-03-15T11:00:00" \ + --attendees "team@company.com" \ + --location "Conference Room A" + +# List upcoming events +gws calendar events list primary --timeMin "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \ + --maxResults 10 --json + +# Quick event (natural language) +gws helpers quick-event "Lunch with Sarah tomorrow at noon" +``` + +### Find Available Time + +```bash +# Check free/busy for multiple people +gws helpers find-time \ + --attendees "alice@co.com,bob@co.com,charlie@co.com" \ + --duration 60 --within "2026-03-15,2026-03-19" --json +``` + +### Standup Report + +```bash +# Generate daily standup from calendar + tasks +gws recipes standup-report --json \ + | python3 scripts/output_analyzer.py --format table + +# Meeting prep (agenda + attendee info) +gws recipes meeting-prep --event-id +``` + +--- + +## Workflow 4: Security Audit + +**Goal:** Audit Google Workspace security configuration and generate remediation commands. + +### Run Full Audit + +```bash +# Full audit across all services +python3 scripts/workspace_audit.py --json + +# Audit specific services +python3 scripts/workspace_audit.py --services gmail,drive,calendar + +# Demo mode (no gws required) +python3 scripts/workspace_audit.py --demo +``` + +### Audit Checks + +| Area | Check | Risk | +|------|-------|------| +| Drive | External sharing enabled | Data exfiltration | +| Gmail | Auto-forwarding rules | Data exfiltration | +| Gmail | DMARC/SPF/DKIM records | Email spoofing | +| Calendar | Default sharing visibility | Information leak | +| OAuth | Third-party app grants | Unauthorized access | +| Admin | Super admin count | Privilege escalation | +| Admin | 2-Step verification enforcement | Account takeover | + +### Review and Remediate + +```bash +# Review findings +python3 scripts/workspace_audit.py --json | python3 scripts/output_analyzer.py \ + --filter "status=FAIL" --select "area,check,remediation" + +# Execute remediation (example: restrict external sharing) +gws drive about get --json # Check current settings +# Follow remediation commands from audit output +``` + +--- + +## Python Tools + +| Script | Purpose | Usage | +|--------|---------|-------| +| `gws_doctor.py` | Pre-flight diagnostics | `python3 scripts/gws_doctor.py [--json] [--services gmail,drive]` | +| `auth_setup_guide.py` | Guided auth setup | `python3 scripts/auth_setup_guide.py --guide oauth` | +| `gws_recipe_runner.py` | Recipe catalog & runner | `python3 scripts/gws_recipe_runner.py --list [--persona pm]` | +| `workspace_audit.py` | Security/config audit | `python3 scripts/workspace_audit.py [--json] [--demo]` | +| `output_analyzer.py` | JSON/NDJSON analysis | `gws ... --json \| python3 scripts/output_analyzer.py --count` | + +All scripts are stdlib-only, support `--json` output, and include demo mode with embedded sample data. + +--- + +## Best Practices + +### Security + +1. Use OAuth with minimal scopes — request only what each workflow needs +2. Store tokens in the system keyring, never in plain text files +3. Rotate service account keys every 90 days +4. Audit third-party OAuth app grants quarterly +5. Use `--dry-run` before bulk destructive operations + +### Automation + +1. Pipe `--json` output through `output_analyzer.py` for filtering and aggregation +2. Use recipes for multi-step operations instead of chaining raw commands +3. Select a persona bundle to scope recipes to your role +4. Use NDJSON format (`--format ndjson`) for streaming large result sets +5. Set `GWS_DEFAULT_FORMAT=json` in your shell profile for scripting + +### Performance + +1. Use `--fields` to request only needed fields (reduces payload size) +2. Use `--limit` to cap results when browsing +3. Use `--page-all` only when you need complete datasets +4. Batch operations with recipes rather than individual API calls +5. Cache frequently accessed data (e.g., label IDs, folder IDs) in variables + +--- + +## Limitations + +| Constraint | Impact | +|------------|--------| +| OAuth tokens expire after 1 hour | Re-auth needed for long-running scripts | +| API rate limits (per-user, per-service) | Bulk operations may hit 429 errors | +| Scope requirements vary by service | Must request correct scopes during auth | +| Pre-v1.0 CLI status | Breaking changes possible between releases | +| Google Cloud project required | Free, but requires setup in Cloud Console | +| Admin API needs admin privileges | Some audit checks require Workspace Admin role | + +### Required Scopes by Service + +```bash +# List scopes for specific services +python3 scripts/auth_setup_guide.py --scopes gmail,drive,calendar,sheets +``` + +| Service | Key Scopes | +|---------|-----------| +| Gmail | `gmail.modify`, `gmail.send`, `gmail.labels` | +| Drive | `drive.file`, `drive.metadata.readonly` | +| Sheets | `spreadsheets` | +| Calendar | `calendar`, `calendar.events` | +| Admin | `admin.directory.user.readonly`, `admin.directory.group` | +| Tasks | `tasks` | diff --git a/docs/skills/engineering-team/index.md b/docs/skills/engineering-team/index.md index 1e62ed3..e695646 100644 --- a/docs/skills/engineering-team/index.md +++ b/docs/skills/engineering-team/index.md @@ -5,7 +5,7 @@ description: "All Engineering - Core skills for Claude Code, OpenAI Codex, and O # Engineering - Core Skills -38 skills in this domain. +39 skills in this domain. | Skill | Description | |-------|-------------| @@ -13,6 +13,7 @@ description: "All Engineering - Core skills for Claude Code, OpenAI Codex, and O | [Code Reviewer](code-reviewer.md) | `code-reviewer` | | [Email Template Builder](email-template-builder.md) | `email-template-builder` | | [Engineering Team Skills](engineering-team.md) | `engineering-team` | +| [Google Workspace CLI](google-workspace-cli.md) | `google-workspace-cli` | | [Incident Commander Skill](incident-commander.md) | `incident-commander` | | [Microsoft 365 Tenant Manager](ms365-tenant-manager.md) | `ms365-tenant-manager` | | [Playwright Pro](playwright-pro.md) | `playwright-pro` | diff --git a/engineering-team/.claude-plugin/plugin.json b/engineering-team/.claude-plugin/plugin.json index 539b150..6d9da1c 100644 --- a/engineering-team/.claude-plugin/plugin.json +++ b/engineering-team/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "engineering-skills", - "description": "23 production-ready engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, and more", + "description": "24 production-ready engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, Google Workspace CLI, and more", "version": "2.1.2", "author": { "name": "Alireza Rezvani", diff --git a/engineering-team/CLAUDE.md b/engineering-team/CLAUDE.md index edba15e..dd56174 100644 --- a/engineering-team/CLAUDE.md +++ b/engineering-team/CLAUDE.md @@ -1,6 +1,6 @@ # Engineering Team Skills - Claude Code Guidance -This guide covers the 18 production-ready engineering skills and their Python automation tools. +This guide covers the 24 production-ready engineering skills and their Python automation tools. ## Engineering Skills Overview @@ -8,7 +8,7 @@ This guide covers the 18 production-ready engineering skills and their Python au - senior-architect, senior-frontend, senior-backend, senior-fullstack - senior-qa, senior-devops, senior-secops - code-reviewer, senior-security -- aws-solution-architect, ms365-tenant-manager, tdd-guide, tech-stack-evaluator +- aws-solution-architect, ms365-tenant-manager, google-workspace-cli, tdd-guide, tech-stack-evaluator **AI/ML/Data (5 skills):** - senior-data-scientist, senior-data-engineer, senior-ml-engineer @@ -287,6 +287,6 @@ services: --- -**Last Updated:** November 5, 2025 -**Skills Deployed:** 18/18 engineering skills production-ready -**Total Tools:** 30+ Python automation tools across core + AI/ML/Data +**Last Updated:** March 11, 2026 +**Skills Deployed:** 24 engineering skills production-ready +**Total Tools:** 35+ Python automation tools across core + AI/ML/Data diff --git a/engineering-team/google-workspace-cli/.claude-plugin/plugin.json b/engineering-team/google-workspace-cli/.claude-plugin/plugin.json new file mode 100644 index 0000000..ae5e2d5 --- /dev/null +++ b/engineering-team/google-workspace-cli/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "google-workspace-cli", + "version": "2.1.2", + "description": "Google Workspace administration via the gws CLI. Install, authenticate, and automate Gmail, Drive, Sheets, Calendar, Docs, Chat, and Tasks. 5 Python tools, 3 reference guides, 43 built-in recipes, 10 persona bundles.", + "author": { + "name": "Alireza Rezvani" + }, + "repository": "https://github.com/alirezarezvani/claude-skills", + "license": "MIT", + "skills": "./", + "homepage": "https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli" +} diff --git a/engineering-team/google-workspace-cli/.gitignore b/engineering-team/google-workspace-cli/.gitignore new file mode 100644 index 0000000..cf4a8f9 --- /dev/null +++ b/engineering-team/google-workspace-cli/.gitignore @@ -0,0 +1,14 @@ +# Python +__pycache__/ +*.pyc +*.pyo + +# Auth tokens +*.token +*.json.bak +.env +.env.* + +# OS +.DS_Store +Thumbs.db diff --git a/engineering-team/google-workspace-cli/SKILL.md b/engineering-team/google-workspace-cli/SKILL.md new file mode 100644 index 0000000..3db811d --- /dev/null +++ b/engineering-team/google-workspace-cli/SKILL.md @@ -0,0 +1,373 @@ +--- +name: "google-workspace-cli" +description: "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." +--- + +# Google Workspace CLI + +Expert 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. + +--- + +## Quick Start + +### Check Installation + +```bash +# Verify gws is installed and authenticated +python3 scripts/gws_doctor.py +``` + +### Send an Email + +```bash +gws gmail users.messages send me --to "team@company.com" \ + --subject "Weekly Update" --body "Here's this week's summary..." +``` + +### List Drive Files + +```bash +gws drive files list --json --limit 20 | python3 scripts/output_analyzer.py --select "name,mimeType,modifiedTime" --format table +``` + +--- + +## Installation + +### npm (recommended) + +```bash +npm install -g @anthropic/gws +gws --version +``` + +### Cargo (from source) + +```bash +cargo install gws-cli +gws --version +``` + +### Pre-built Binaries + +Download from [github.com/googleworkspace/cli/releases](https://github.com/googleworkspace/cli/releases) for macOS, Linux, or Windows. + +### Verify Installation + +```bash +python3 scripts/gws_doctor.py +# Checks: PATH, version, auth status, service connectivity +``` + +--- + +## Authentication + +### OAuth Setup (Interactive) + +```bash +# Step 1: Create Google Cloud project and OAuth credentials +python3 scripts/auth_setup_guide.py --guide oauth + +# Step 2: Run auth setup +gws auth setup + +# Step 3: Validate +gws auth status --json +``` + +### Service Account (Headless/CI) + +```bash +# Generate setup instructions +python3 scripts/auth_setup_guide.py --guide service-account + +# Configure with key file +export GWS_SERVICE_ACCOUNT_KEY=/path/to/key.json +export GWS_DELEGATED_USER=admin@company.com +gws auth status +``` + +### Environment Variables + +```bash +# Generate .env template +python3 scripts/auth_setup_guide.py --generate-env +``` + +| Variable | Purpose | +|----------|---------| +| `GWS_CLIENT_ID` | OAuth client ID | +| `GWS_CLIENT_SECRET` | OAuth client secret | +| `GWS_TOKEN_PATH` | Custom token storage path | +| `GWS_SERVICE_ACCOUNT_KEY` | Service account JSON key path | +| `GWS_DELEGATED_USER` | User to impersonate (service accounts) | +| `GWS_DEFAULT_FORMAT` | Default output format (json/ndjson/table) | + +### Validate Authentication + +```bash +python3 scripts/auth_setup_guide.py --validate --json +# Tests each service endpoint +``` + +--- + +## Workflow 1: Gmail Automation + +**Goal:** Automate email operations — send, search, label, and filter management. + +### Send and Reply + +```bash +# Send a new email +gws gmail users.messages send me --to "client@example.com" \ + --subject "Proposal" --body "Please find attached..." \ + --attachment proposal.pdf + +# Reply to a thread +gws gmail users.messages reply me --thread-id \ + --body "Thanks for your feedback..." + +# Forward a message +gws gmail users.messages forward me --message-id \ + --to "manager@company.com" +``` + +### Search and Filter + +```bash +# Search emails +gws gmail users.messages list me --query "from:client@example.com after:2025/01/01" --json \ + | python3 scripts/output_analyzer.py --count + +# List labels +gws gmail users.labels list me --json + +# Create a filter +gws gmail users.settings.filters create me \ + --criteria '{"from":"notifications@service.com"}' \ + --action '{"addLabelIds":["Label_123"],"removeLabelIds":["INBOX"]}' +``` + +### Bulk Operations + +```bash +# Archive all read emails older than 30 days +gws gmail users.messages list me --query "is:read older_than:30d" --json \ + | python3 scripts/output_analyzer.py --select "id" --format json \ + | xargs -I {} gws gmail users.messages modify me {} --removeLabelIds INBOX +``` + +--- + +## Workflow 2: Drive & Sheets + +**Goal:** Manage files, create spreadsheets, configure sharing, and export data. + +### File Operations + +```bash +# List files +gws drive files list --json --limit 50 \ + | python3 scripts/output_analyzer.py --select "name,mimeType,size" --format table + +# Upload a file +gws drive files create --name "Q1 Report" --upload report.pdf \ + --parents + +# Create a Google Sheet +gws sheets spreadsheets create --title "Budget 2026" --json + +# Download/export +gws drive files export --mime "application/pdf" --output report.pdf +``` + +### Sharing + +```bash +# Share with user +gws drive permissions create \ + --type user --role writer --emailAddress "colleague@company.com" + +# Share with domain (view only) +gws drive permissions create \ + --type domain --role reader --domain "company.com" + +# List who has access +gws drive permissions list --json +``` + +### Sheets Data + +```bash +# Read a range +gws sheets spreadsheets.values get --range "Sheet1!A1:D10" --json + +# Write data +gws sheets spreadsheets.values update --range "Sheet1!A1" \ + --values '[["Name","Score"],["Alice",95],["Bob",87]]' + +# Append rows +gws sheets spreadsheets.values append --range "Sheet1!A1" \ + --values '[["Charlie",92]]' +``` + +--- + +## Workflow 3: Calendar & Meetings + +**Goal:** Schedule events, find available times, and generate standup reports. + +### Event Management + +```bash +# Create an event +gws calendar events insert primary \ + --summary "Sprint Planning" \ + --start "2026-03-15T10:00:00" --end "2026-03-15T11:00:00" \ + --attendees "team@company.com" \ + --location "Conference Room A" + +# List upcoming events +gws calendar events list primary --timeMin "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \ + --maxResults 10 --json + +# Quick event (natural language) +gws helpers quick-event "Lunch with Sarah tomorrow at noon" +``` + +### Find Available Time + +```bash +# Check free/busy for multiple people +gws helpers find-time \ + --attendees "alice@co.com,bob@co.com,charlie@co.com" \ + --duration 60 --within "2026-03-15,2026-03-19" --json +``` + +### Standup Report + +```bash +# Generate daily standup from calendar + tasks +gws recipes standup-report --json \ + | python3 scripts/output_analyzer.py --format table + +# Meeting prep (agenda + attendee info) +gws recipes meeting-prep --event-id +``` + +--- + +## Workflow 4: Security Audit + +**Goal:** Audit Google Workspace security configuration and generate remediation commands. + +### Run Full Audit + +```bash +# Full audit across all services +python3 scripts/workspace_audit.py --json + +# Audit specific services +python3 scripts/workspace_audit.py --services gmail,drive,calendar + +# Demo mode (no gws required) +python3 scripts/workspace_audit.py --demo +``` + +### Audit Checks + +| Area | Check | Risk | +|------|-------|------| +| Drive | External sharing enabled | Data exfiltration | +| Gmail | Auto-forwarding rules | Data exfiltration | +| Gmail | DMARC/SPF/DKIM records | Email spoofing | +| Calendar | Default sharing visibility | Information leak | +| OAuth | Third-party app grants | Unauthorized access | +| Admin | Super admin count | Privilege escalation | +| Admin | 2-Step verification enforcement | Account takeover | + +### Review and Remediate + +```bash +# Review findings +python3 scripts/workspace_audit.py --json | python3 scripts/output_analyzer.py \ + --filter "status=FAIL" --select "area,check,remediation" + +# Execute remediation (example: restrict external sharing) +gws drive about get --json # Check current settings +# Follow remediation commands from audit output +``` + +--- + +## Python Tools + +| Script | Purpose | Usage | +|--------|---------|-------| +| `gws_doctor.py` | Pre-flight diagnostics | `python3 scripts/gws_doctor.py [--json] [--services gmail,drive]` | +| `auth_setup_guide.py` | Guided auth setup | `python3 scripts/auth_setup_guide.py --guide oauth` | +| `gws_recipe_runner.py` | Recipe catalog & runner | `python3 scripts/gws_recipe_runner.py --list [--persona pm]` | +| `workspace_audit.py` | Security/config audit | `python3 scripts/workspace_audit.py [--json] [--demo]` | +| `output_analyzer.py` | JSON/NDJSON analysis | `gws ... --json \| python3 scripts/output_analyzer.py --count` | + +All scripts are stdlib-only, support `--json` output, and include demo mode with embedded sample data. + +--- + +## Best Practices + +### Security + +1. Use OAuth with minimal scopes — request only what each workflow needs +2. Store tokens in the system keyring, never in plain text files +3. Rotate service account keys every 90 days +4. Audit third-party OAuth app grants quarterly +5. Use `--dry-run` before bulk destructive operations + +### Automation + +1. Pipe `--json` output through `output_analyzer.py` for filtering and aggregation +2. Use recipes for multi-step operations instead of chaining raw commands +3. Select a persona bundle to scope recipes to your role +4. Use NDJSON format (`--format ndjson`) for streaming large result sets +5. Set `GWS_DEFAULT_FORMAT=json` in your shell profile for scripting + +### Performance + +1. Use `--fields` to request only needed fields (reduces payload size) +2. Use `--limit` to cap results when browsing +3. Use `--page-all` only when you need complete datasets +4. Batch operations with recipes rather than individual API calls +5. Cache frequently accessed data (e.g., label IDs, folder IDs) in variables + +--- + +## Limitations + +| Constraint | Impact | +|------------|--------| +| OAuth tokens expire after 1 hour | Re-auth needed for long-running scripts | +| API rate limits (per-user, per-service) | Bulk operations may hit 429 errors | +| Scope requirements vary by service | Must request correct scopes during auth | +| Pre-v1.0 CLI status | Breaking changes possible between releases | +| Google Cloud project required | Free, but requires setup in Cloud Console | +| Admin API needs admin privileges | Some audit checks require Workspace Admin role | + +### Required Scopes by Service + +```bash +# List scopes for specific services +python3 scripts/auth_setup_guide.py --scopes gmail,drive,calendar,sheets +``` + +| Service | Key Scopes | +|---------|-----------| +| Gmail | `gmail.modify`, `gmail.send`, `gmail.labels` | +| Drive | `drive.file`, `drive.metadata.readonly` | +| Sheets | `spreadsheets` | +| Calendar | `calendar`, `calendar.events` | +| Admin | `admin.directory.user.readonly`, `admin.directory.group` | +| Tasks | `tasks` | diff --git a/engineering-team/google-workspace-cli/assets/persona-profiles.md b/engineering-team/google-workspace-cli/assets/persona-profiles.md new file mode 100644 index 0000000..cec78c1 --- /dev/null +++ b/engineering-team/google-workspace-cli/assets/persona-profiles.md @@ -0,0 +1,223 @@ +# Google Workspace CLI Persona Profiles + +10 role-based bundles that scope recipes and commands to your daily workflow. + +--- + +## 1. Executive Assistant + +**Description:** Managing schedules, emails, and communications for executives. + +**Top Commands:** +- `gws helpers morning-briefing` — Start the day with schedule + inbox overview +- `gws helpers find-time` — Find available slots for meetings +- `gws helpers meeting-prep --event-id ` — Prepare meeting agenda +- `gws gmail users.messages send me` — Send emails on behalf +- `gws helpers eod-wrap` — End of day summary + +**Recommended Recipes:** morning-briefing, today-schedule, find-time, send-email, reply-to-thread, meeting-prep, eod-wrap, quick-event, inbox-zero, standup-report + +**Daily Workflow:** +1. Run `morning-briefing` at 8:00 AM +2. Process inbox with `inbox-zero` +3. Schedule meetings with `find-time` + `create-event` +4. Prep for meetings with `meeting-prep` +5. Close day with `eod-wrap` + +--- + +## 2. Project Manager + +**Description:** Tracking tasks, meetings, and project deliverables. + +**Top Commands:** +- `gws recipes standup-report` — Generate standup updates +- `gws helpers find-time` — Schedule sprint ceremonies +- `gws tasks tasks insert` — Create and assign tasks +- `gws sheets spreadsheets.values get` — Read project trackers +- `gws recipes project-status` — Aggregate project status + +**Recommended Recipes:** standup-report, create-event, find-time, task-create, task-progress, project-status, weekly-summary, share-folder, sheet-read, morning-briefing + +**Daily Workflow:** +1. Run `standup-report` before standup +2. Update project tracker via `sheet-write` +3. Create action items with `task-create` +4. Run `weekly-summary` on Fridays +5. Share updates via `chat-message` + +--- + +## 3. HR + +**Description:** Managing people, onboarding, and team communications. + +**Top Commands:** +- `gws admin users list` — List all domain users +- `gws admin users get ` — Look up employee details +- `gws docs documents create` — Create onboarding docs +- `gws drive permissions create` — Share folders with new hires +- `gws people people.connections list` — Export contact directory + +**Recommended Recipes:** list-users, user-info, send-email, create-event, create-doc, share-folder, chat-message, list-groups, export-contacts, today-schedule + +**Daily Workflow:** +1. Check new hire onboarding queue +2. Create welcome docs with `create-doc` +3. Set up 1:1s with `create-event` +4. Share team folders with `share-folder` +5. Send announcements via `send-email` + +--- + +## 4. Sales + +**Description:** Managing client communications, proposals, and scheduling. + +**Top Commands:** +- `gws gmail users.messages send me` — Send proposals and follow-ups +- `gws gmail users.messages list me --query` — Search client conversations +- `gws helpers find-time` — Schedule client meetings +- `gws docs documents create` — Create proposals +- `gws sheets spreadsheets.values update` — Update pipeline tracker + +**Recommended Recipes:** send-email, search-emails, create-event, find-time, create-doc, share-file, sheet-read, sheet-write, export-file, morning-briefing + +**Daily Workflow:** +1. Run `morning-briefing` for meeting overview +2. Search emails for client updates +3. Update pipeline in Sheets +4. Send proposals via `send-email` + `share-file` +5. Schedule follow-ups with `create-event` + +--- + +## 5. IT Admin + +**Description:** Managing Workspace configuration, security, and user administration. + +**Top Commands:** +- `gws admin users list --domain` — Audit user accounts +- `gws admin activities list login` — Monitor login activity +- `gws admin groups list` — Manage groups +- `python3 workspace_audit.py` — Run security audit +- `gws drive files list --orderBy "quotaBytesUsed desc"` — Find storage hogs + +**Recommended Recipes:** list-users, list-groups, user-info, audit-logins, drive-activity, find-large-files, cleanup-trash, label-manager, filter-setup, share-folder + +**Daily Workflow:** +1. Check `audit-logins` for suspicious activity +2. Run `workspace_audit.py` weekly +3. Process user provisioning requests +4. Monitor storage with `find-large-files` +5. Review group memberships + +--- + +## 6. Developer + +**Description:** Using Workspace APIs for automation and data integration. + +**Top Commands:** +- `gws sheets spreadsheets.values get` — Read config/data from Sheets +- `gws sheets spreadsheets.values update` — Write results to Sheets +- `gws drive files create --upload` — Upload build artifacts +- `gws chat spaces.messages create` — Post deployment notifications +- `gws tasks tasks insert` — Create tasks from CI/CD + +**Recommended Recipes:** sheet-read, sheet-write, sheet-append, upload-file, create-doc, chat-message, task-create, list-files, export-file, send-email + +**Daily Workflow:** +1. Read config from Sheets API +2. Run automated reports to Sheets +3. Post updates to Chat spaces +4. Upload artifacts to Drive +5. Create tasks for bugs/issues + +--- + +## 7. Marketing + +**Description:** Managing campaigns, content creation, and team coordination. + +**Top Commands:** +- `gws docs documents create` — Draft blog posts and briefs +- `gws drive files create --upload` — Upload creative assets +- `gws sheets spreadsheets.values append` — Log campaign metrics +- `gws gmail users.messages send me` — Send campaign emails +- `gws chat spaces.messages create` — Coordinate with team + +**Recommended Recipes:** send-email, create-doc, share-file, upload-file, create-sheet, sheet-write, chat-message, create-event, email-stats, weekly-summary + +**Daily Workflow:** +1. Check `email-stats` for campaign performance +2. Create content in Docs +3. Upload assets to shared Drive folders +4. Update metrics in Sheets +5. Coordinate launches via Chat + +--- + +## 8. Finance + +**Description:** Managing spreadsheets, financial reports, and data analysis. + +**Top Commands:** +- `gws sheets spreadsheets.values get` — Pull financial data +- `gws sheets spreadsheets.values update` — Update forecasts +- `gws sheets spreadsheets create` — Create new reports +- `gws drive files export` — Export reports as PDF +- `gws drive permissions create` — Share with auditors + +**Recommended Recipes:** sheet-read, sheet-write, sheet-append, create-sheet, export-file, share-file, send-email, find-large-files, drive-activity, weekly-summary + +**Daily Workflow:** +1. Pull latest data into Sheets +2. Update financial models +3. Generate PDF reports with `export-file` +4. Share reports with stakeholders +5. Weekly summary for leadership + +--- + +## 9. Legal + +**Description:** Managing documents, contracts, and compliance. + +**Top Commands:** +- `gws docs documents create` — Draft contracts +- `gws drive files export` — Export final versions as PDF +- `gws drive permissions create` — Manage document access +- `gws gmail users.messages list me --query` — Search for compliance emails +- `gws admin activities list` — Audit trail for compliance + +**Recommended Recipes:** create-doc, share-file, export-file, search-emails, send-email, upload-file, list-files, drive-activity, audit-logins, find-large-files + +**Daily Workflow:** +1. Draft and review documents +2. Search email for contract references +3. Export finalized docs as PDF +4. Set precise sharing permissions +5. Maintain audit trail + +--- + +## 10. Customer Support + +**Description:** Managing customer communications and ticket tracking. + +**Top Commands:** +- `gws gmail users.messages list me --query` — Search customer emails +- `gws gmail users.messages reply me` — Reply to tickets +- `gws gmail users.labels create` — Organize by ticket status +- `gws tasks tasks insert` — Create follow-up tasks +- `gws chat spaces.messages create` — Escalate to team + +**Recommended Recipes:** search-emails, send-email, reply-to-thread, label-manager, filter-setup, task-create, chat-message, unread-digest, inbox-zero, morning-briefing + +**Daily Workflow:** +1. Run `morning-briefing` for ticket overview +2. Process inbox with label-based triage +3. Reply to open tickets +4. Escalate via Chat for urgent issues +5. Create follow-up tasks for pending items diff --git a/engineering-team/google-workspace-cli/assets/workspace-config.json b/engineering-team/google-workspace-cli/assets/workspace-config.json new file mode 100644 index 0000000..2bb4e0f --- /dev/null +++ b/engineering-team/google-workspace-cli/assets/workspace-config.json @@ -0,0 +1,61 @@ +{ + "_comment": "Google Workspace CLI automation config template. Copy and customize for your environment.", + "auth": { + "method": "oauth", + "client_id": "", + "client_secret": "", + "token_path": "~/.config/gws/token.json", + "service_account_key": "", + "delegated_user": "" + }, + "defaults": { + "output_format": "json", + "pagination_limit": 100, + "timeout_ms": 30000, + "log_level": "warn" + }, + "persona": "developer", + "scopes": [ + "gmail.modify", + "gmail.send", + "drive.file", + "drive.metadata.readonly", + "spreadsheets", + "calendar", + "calendar.events", + "tasks" + ], + "scheduled_tasks": [ + { + "name": "morning-briefing", + "recipe": "morning-briefing", + "schedule": "0 8 * * 1-5", + "output": "~/workspace-reports/morning-{date}.json" + }, + { + "name": "eod-wrap", + "recipe": "eod-wrap", + "schedule": "0 17 * * 1-5", + "output": "~/workspace-reports/eod-{date}.json" + }, + { + "name": "weekly-summary", + "recipe": "weekly-summary", + "schedule": "0 9 * * 5", + "output": "~/workspace-reports/weekly-{date}.json" + }, + { + "name": "security-audit", + "command": "python3 scripts/workspace_audit.py --json", + "schedule": "0 10 * * 1", + "output": "~/workspace-reports/audit-{date}.json" + } + ], + "aliases": { + "inbox": "gws gmail users.messages list me --query 'is:inbox' --limit 20 --json", + "unread": "gws gmail users.messages list me --query 'is:unread' --limit 20 --json", + "files": "gws drive files list --limit 20 --json", + "events": "gws calendar events list primary --timeMin $(date -u +%Y-%m-%dT%H:%M:%SZ) --maxResults 10 --json", + "tasks": "gws tasks tasks list @default --json" + } +} diff --git a/engineering-team/google-workspace-cli/references/gws-command-reference.md b/engineering-team/google-workspace-cli/references/gws-command-reference.md new file mode 100644 index 0000000..597836e --- /dev/null +++ b/engineering-team/google-workspace-cli/references/gws-command-reference.md @@ -0,0 +1,313 @@ +# Google Workspace CLI Command Reference + +Comprehensive reference for the `gws` CLI covering 18 services, 22 helper commands, global flags, and environment variables. + +--- + +## Global Flags + +| Flag | Description | +|------|-------------| +| `--json` | Output as JSON | +| `--format ndjson` | Output as newline-delimited JSON | +| `--dry-run` | Show what would be done without executing | +| `--limit ` | Maximum results to return | +| `--page-all` | Fetch all pages of results | +| `--fields ` | Partial response field mask | +| `--quiet` | Suppress non-error output | +| `--verbose` | Verbose debug output | +| `--timeout ` | Request timeout in milliseconds | + +--- + +## Environment Variables + +| Variable | Description | Default | +|----------|-------------|---------| +| `GWS_CLIENT_ID` | OAuth client ID | — | +| `GWS_CLIENT_SECRET` | OAuth client secret | — | +| `GWS_TOKEN_PATH` | Token storage location | `~/.config/gws/token.json` | +| `GWS_SERVICE_ACCOUNT_KEY` | Service account JSON key path | — | +| `GWS_DELEGATED_USER` | User to impersonate (service accounts) | — | +| `GWS_DEFAULT_FORMAT` | Default output format | `text` | +| `GWS_PAGINATION_LIMIT` | Default pagination limit | `100` | +| `GWS_LOG_LEVEL` | Logging level (debug/info/warn/error) | `warn` | + +--- + +## Services + +### Gmail + +```bash +gws gmail users.messages list me --query "" --json +gws gmail users.messages get me --json +gws gmail users.messages send me --to --subject --body +gws gmail users.messages reply me --thread-id --body +gws gmail users.messages forward me --message-id --to +gws gmail users.messages modify me --addLabelIds