Gog 1

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Security Scan

The skill is internally consistent: it is an instruction-only wrapper that expects a 'gog' Google Workspace CLI binary (installable via a Homebrew tap) and its runtime instructions match that purpose.

Purpose & Capability

The name/description (Google Workspace CLI) match the declared requirements: the skill requires the 'gog' binary and offers commands for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. Requesting a gog binary and offering a Homebrew install is appropriate for this purpose.

Instruction Scope

SKILL.md only instructs the agent to run the gog CLI and perform OAuth setup (pointing to a local client_secret.json) and typical goog workspace operations. It does not ask the agent to read unrelated files, system secrets, or exfiltrate data to other endpoints. It does reference writing an exported doc to /tmp and suggests using GOG_ACCOUNT to avoid repeating --account, both expected and limited in scope.

Install Mechanism

Installation is via Homebrew formula steipete/tap/gogcli which will create the 'gog' binary. Homebrew is a normal install path, but this is a third‑party tap (not the default Homebrew/core). Verify the tap's GitHub/repository and formula contents before installing to ensure the binary's provenance and review build/install steps.

Credentials

The skill declares no required environment variables. The runtime notes mention GOG_ACCOUNT (optional) and local OAuth client_secret.json files — these are proportional to a Google API CLI. Users should still protect OAuth client secrets and grant the minimum OAuth scopes needed.

Persistence & Privilege

The skill is not forced-always and does not request persistent system-wide configuration or other skills' credentials. Autonomous model invocation is allowed (platform default) but not excessive in this skill's metadata.

Assessment

This skill appears to do what it says: it expects a standalone 'gog' CLI and instructs you how to use it. Before installing, verify the Homebrew tap (steipete/tap/gogcli) and inspect the formula or the project's GitHub to confirm the binary's source. Protect your OAuth client_secret.json (store it securely), grant only needed Google API scopes, and be aware that the installed 'gog' binary will have normal filesystem and network access (it can read files you point it at and call Google APIs). If you will allow the agent to invoke the skill autonomously, consider limiting the agent's permissions or confirm prompts for sensitive actions like sending email.

gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Setup (once)

• gog auth credentials /path/to/client_secret.json
• gog auth add [e-mail] --services gmail,calendar,drive,contacts,sheets,docs
• gog auth list

Common commands

• Gmail search: gog gmail search 'newer_than:7d' --max 10
• Gmail send: gog gmail send --to [e-mail] --subject "Hi" --body "Hello"
• Calendar: gog calendar events <calendarId> --from <iso> --to <iso>
• Drive search: gog drive search "query" --max 10
• Contacts: gog contacts list --max 20
• Sheets get: gog sheets get <sheetId> "Tab!A1:D10" --json
• Sheets update: gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Sheets append: gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Sheets clear: gog sheets clear <sheetId> "Tab!A2:Z"
• Sheets metadata: gog sheets metadata <sheetId> --json
• Docs export: gog docs export <docId> --format txt --out /tmp/doc.txt
• Docs cat: gog docs cat <docId>

Notes

• Set GOG_ACCOUNT=[e-mail] to avoid repeating --account.
• For scripting, prefer --json plus --no-input.
• Sheets values can be passed via --values-json (recommended) or as inline rows.
• Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
• Confirm before sending mail or creating events.