用途：当用户需要读取邮件、发送邮件、搜索 Gmail、列出邮件、查看收件箱、管理标签、查找邮件，以及查看和操作 Google 日历时使用本技能。命令返回 JSON，含 success 与 data 字段。
首次设置：运行 npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gmail/scripts/gmail.ts auth 进行 Google OAuth 授权，会打开浏览器；令牌按项目存储在 .claude/google-skill.local.json。默认使用内置 OAuth 凭据，也可自建 Google Cloud 项目并启用相关 API、创建桌面型 OAuth 2.0 凭据，将 JSON 保存到 ~/.config/google-skill/credentials.json，技能会自动改用该文件。
主要能力：邮件方面支持 list（可用 --query 与 --max）、read 按 message-id 读取、send 发送纯文本/HTML 邮件并支持 --attachment 附件、labels 与 label 管理标签、download 下载为 EML、draft 创建草稿、send-md 将 Markdown 转为样式化 HTML 邮件（--style 可选 client 或 labs，--draft 可仅建草稿，主题默认取 Markdown 首个 H1 或由 --subject 指定）；内联图片可用 --inline。日历方面支持 calendars 列出日历、events 列出即将到来的事件、event 查看详情、create 创建事件、delete 删除事件。搜索支持 from、to、subject、is:unread、has:attachment、newer_than、label 等运算符。可用 check 检查授权，--help 查看帮助。
限制：资料未提供收费、配额、平台支持范围及错误处理等细节；使用需先完成 OAuth 授权并授予相应权限，凭据文件与令牌文件位置需按上述路径保存。