SkillsAdd

tumf/skills

gogcli

Fast, script-friendly CLI for Google services via `gog`. Use this skill whenever the user needs to work with Gmail, Google Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Contacts, Tasks, People, Chat, Classroom, Groups, Admin, or Keep from the terminal, especially for Google Workspace automation, account setup, OAuth/client configuration, service accounts, domain-wide delegation, or JSON/scriptable workflows. Prefer this skill even when the user does not mention `gog` explicitly but…

First seen Feb 20, 2026

Installation

$ npx skills add tumf/skills --skill gogcli
View on skills.sh ↗ GitHub repository ↗

Summary

  • Fast, script-friendly CLI for Google services via `gog`.
  • Use this skill whenever the user needs to work with Gmail, Google Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Contacts, Tasks, People, Chat, Classroom, Groups, Admin, or Keep from the terminal, especially for Google Workspace automation, account setup, OAuth/client configuration, service accounts, domain-wide delegation, or JSON/scriptable workflows.
  • Prefer this skill even when the user does not mention `gog` explicitly but is clearly trying to automate or inspect Google services from a CLI or agent workflow.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from tumf/skills · top by installs.

npx skills add tumf/skills
firecrawl 125 opencode-agent-creator 91 opencode-command-creator 29 openclaw-agent-creator 29 agentic-cli-design 29 product-improvement-proposal 23 rust-cli 19 slack-rs 18 clawdbot-config 18 jp-grants 14

Browse all from tumf/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 4
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,874 B
  • docs SUMMARY.md 600 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 23 installs

SKILL.md

gogcli - Google in your terminal

Overview

gog is a script-friendly CLI for Google services with JSON-first output, multiple accounts, and flexible authentication. This skill is for agents that need to inspect or automate Google Workspace and Gmail workflows safely.

Core areas:

  • Gmail: search, read, send, drafts, labels, filters, watch webhooks, tracking
  • Calendar: events, invites, team calendars, free/busy, conflicts, special event types
  • Drive: list/search/upload/download/share/move/delete, shared drives
  • Docs / Slides / Sheets: create, copy, export, update, formatting helpers
  • Contacts / People / Tasks
  • Chat, Classroom, Forms, Apps Script
  • Groups, Admin, Keep in Workspace environments

Installation

See references/installation.md.

Authentication Quick Start

For first-time setup, see references/oauth.md and references/apis.md.

Minimal happy path:

gog auth credentials ~/Downloads/client_secret_*.json
gog auth add [email protected]

gog auth list
export [email protected]
gog auth status
gog gmail labels list

gog auth status only shows the current/selected account context. To confirm which accounts are authenticated at all, check gog auth list.

Authentication Model

gog supports:

  • Multiple accounts via --account / GOG_ACCOUNT
  • Account aliases via gog auth alias ...
  • Multiple OAuth clients via --client / GOG_CLIENT
  • Keyring backends: auto, keychain, file
  • Least-privilege auth with --readonly, --drive-scope, --gmail-scope
  • Workspace service accounts with domain-wide delegation

See details in references/oauth.md.

Workspace service accounts

For Workspace-only flows such as Keep or Admin, verify service-account configuration before acting.

Quick check:

gog --account [email protected] auth status

See full setup in references/oauth.md.

Output and automation conventions

  • Default output is human-readable.
  • Use --json for machine-readable scripting.
  • Use --plain for stable TSV-like output.
  • Human hints/progress go to stderr.
  • Prefer read-only discovery before mutating commands.

Recommended preflight pattern:

gog auth status --json
gog gmail labels list --json
gog calendar calendars --json
gog drive ls --max 5 --json

Common command patterns

See references/commands.md.

Agent guidance

  • First confirm the target account with gog auth status or explicit --account.
  • Use --json whenever downstream parsing matters.
  • Prefer the smallest scope set that can accomplish the task.
  • For Workspace-only commands, verify service-account/domain-wide-delegation status first.
  • For Gmail watch/tracking flows, verify external webhook URLs and auth before enabling writes.
  • Do not assume consumer Gmail accounts can use Chat, Admin, Groups, or Keep service-account flows.

References