Agent skill

Gog Gmail

by openclaw in openclaw/gogcli

“Gmail operations through gog.”

— description from SKILL.md by openclaw
MITAuto-check passedProductivity & Automation

Install Gog Gmail

skills CLI
$ npx skills add openclaw/gogcli --skill gog-gmail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openclaw/gogcli gog-gmail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openclaw/gogcli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/gog-gmail .claude/skills/gog-gmail && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gog-gmail
GitHub stars
8.5k
Token cost
~530 tokens
SKILL.md length
226 words
Files
2
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Safe start and Commands
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Gog Gmail is a skill in openclaw/gogcli (8.5k stars). Its SKILL.md is about 530 tokens, with 1 other file in the folder. Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit 4d7478e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gog Gmail loads about 530 tokens when it runs. Until then it costs about 10 tokens; SKILL.md has 226 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~10
When it runs · the whole SKILL.md, loaded when a task matches
~530

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openclaw/gogcli at commit 4d7478e, republished under its MIT licence (© openclaw). 226 words, ~530 tokens.

Download SKILL.mdSave it as .claude/skills/gog-gmail/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
gog-gmail
description
Gmail operations through gog.

Gmail

<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->

Use gog for Gmail operations. Read ../gog/SKILL.md first for shared auth, output, safety, and live-write rules.

Safe start

bash
gog auth list --check --json --no-input
gog schema gmail --json
gog --readonly --account user@example.com gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted
  • Select the account explicitly with --account.
  • Use --json --wrap-untrusted for agent-readable Google content.
  • Use --readonly when the task must not mutate Google data.
  • Use --no-input in automation and --dry-run before supported writes.
  • Confirm the exact account, object, and mutation before any write or delete.

Commands

CommandPurpose
archiveArchive messages or explicit threads (remove from inbox)
attachmentDownload a single attachment
autoreplyReply once to matching messages
batchBatch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing)
draftsDraft operations
forwardForward a message to new recipients
getGet a message (full|metadata|raw)
historyGmail history
importImport an RFC822/EML message into Gmail
labelsLabel operations
mark-readMark messages as read
messagesMessage operations
rawDump raw Gmail API response as JSON (Users.Messages.Get; lossless; for scripting and LLM consumption)
replyReply to a message
reply-allReply to all message participants
searchSearch threads using Gmail query syntax
sendSend an email
settingsSettings and admin
threadThread operations (get, modify)
trackEmail open tracking
trashMove messages to trash
unreadMark messages as unread
urlPrint Gmail web URLs for threads

Run gog gmail <command> --help for flags and gog schema gmail <command> --json for the machine-readable contract. Do not guess command syntax.

© openclaw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/gog-gmail of openclaw/gogcli.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 4d7478e

Compare with similar skills

Gog Gmail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gog Gmail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gog Gmail this skillopenclaw/gogcli8.5k—~530Automated safety check: PassMIT
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops74k—~233Automated safety check: NotesMIT
Gmailteam-attention/plugins-for-claude-natives825—~967Automated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Gmail Emailopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Zeleremorses/zele299—~1.3kAutomated safety check: PassNone

Similar skills

  • Career-Ops Gmail Lead Plugin

    career-ops-hq/career-ops

    Pulls job leads from a Gmail label into the career-ops pipeline, extracting job URLs from DMARC-passing emails and de-duplicating against existing leads.

    74k GitHub stars~233 tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Gmail

    team-attention/plugins-for-claude-natives

    This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.

    825 GitHub stars~967 tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed
  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Gmail Email

    open-gitagent/gitagent

    Send emails via Gmail SMTP using App Password authentication.

    710 GitHub stars~235 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Zele

    remorses/zele

    zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.

    299 GitHub stars~1.3k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed
  • Google Workspace

    yc-software/qm

    Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.

    15k GitHub stars~1.8k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from openclaw/gogcli

All 32 skills in this repo
  • Gog

    openclaw/gogcli

    gog CLI: safe Google Workspace automation, JSON, auth, scoped reads/writes.

    8.5k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Crabbox

    openclaw/gogcli

    Use the Crabbox wrapper for OpenClaw remote validation across Linux, macOS, Windows, and WSL2, including delegated Blacksmith Testbox proof.

    8.5k GitHub stars~8k tokensUpdated today
    Auto-check: notes
  • Gog Analytics

    openclaw/gogcli

    Google Analytics operations through gog. An agent skill from openclaw/gogcli.

    8.5k GitHub stars~272 tokensUpdated today
    Auto-check passed
  • Gog Classroom

    openclaw/gogcli

    Google Classroom operations through gog. An agent skill from openclaw/gogcli.

    8.5k GitHub stars~360 tokensUpdated today
    Auto-check passed
  • Gog Searchconsole

    openclaw/gogcli

    Google Search Console operations through gog. An agent skill from openclaw/gogcli.

    8.5k GitHub stars~321 tokensUpdated today
    Auto-check passed
  • Gog Contacts Cleanup

    openclaw/gogcli

    Google Contacts duplicate review and guarded cleanup with gog.

    8.5k GitHub stars~247 tokensUpdated today
    Auto-check passed

Works with

Questions about Gog Gmail

How do I install Gog Gmail in Claude Code?

Run `npx skills add openclaw/gogcli --skill gog-gmail -a claude-code`. Or copy the skill folder (.agents/skills/gog-gmail in openclaw/gogcli) into .claude/skills/gog-gmail in your project. Claude Code loads it when a task matches its description.

How do I install Gog Gmail in Codex?

Run `npx skills add openclaw/gogcli --skill gog-gmail -a codex`. Or copy the skill folder (.agents/skills/gog-gmail in openclaw/gogcli) into .agents/skills/gog-gmail in your project. Codex loads it when a task matches its description.

Can I use Gog Gmail in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openclaw/gogcli --skill gog-gmail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gog-gmail, .gemini/skills/gog-gmail, .github/skills/gog-gmail and .opencode/skills/gog-gmail in your project.

What does Gog Gmail need to run?

SKILL.md names no scripts, command-line tools or credentials: Gog Gmail is instructions for the agent only.

Does Gog Gmail access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gog Gmail safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gog Gmail use?

Gog Gmail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gog Gmail use?

About 530 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gog Gmail?

Skills that share tags, products or a category with Gog Gmail: Career-Ops Gmail Lead Plugin (career-ops-hq/career-ops, 74k stars), Gmail (team-attention/plugins-for-claude-natives, 825 stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Gmail Email (open-gitagent/gitagent, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gog Gmail?

openclaw (a GitHub organization) maintains it in openclaw/gogcli, which has 8,480 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 7, 2026.

Source: openclaw/gogcli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.