用途：通过命令行读取、创建和管理 Google 日历事件，适合让助手代为查看日程、安排会议、检查空闲时间等场景。
主要能力：查看今日事件、本周事件、指定天数的时间线（agenda）、获取事件详情、搜索事件、创建事件、删除事件、列出日历、管理账号。支持多账号，通过 --account EMAIL 切换。创建事件支持标题、起止时间、地点、描述、参与者、目标日历、Google 颜色 id（1-11）。还支持从 JSON 文件批量创建事件（bulk-create），--dry-run 可先预览不调用 API。
使用方式：需 Python 3.9+，安装依赖 pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client requests。首次配置需在 Google Cloud Console 启用 Google Calendar API，使用或新建 OAuth 桌面客户端，将 JSON 保存为 ~/.claude/skills/gcal-skill/credentials.json；若已有 gmail-skill 凭据会复用。随后运行任意命令，浏览器会打开进行授权。常用命令如：python3 ~/.claude/skills/gcal-skill/gcal_skill.py today、week、agenda --days 14、search "query"、calendars。创建事件命令：python3 ~/.claude/skills/gcal-skill/gcal_skill.py create --title "..." --start "2026-01-20 14:00" --end "..."。时间格式支持 2026-01-20 14:00、2:00 PM、14:00（今天）等。
限制与安全：创建任何日历事件前必须先向用户展示完整事件详情并获得明确确认，仅在用户确认后运行创建命令。令牌本地存储在 ~/.claude/skills/gcal-skill/tokens/，可随时在 Google 账号权限页撤销访问。所有命令输出 JSON。批量创建时每个事件键包括 title（必需）、start（必需）、end、location、description、color、attendees。部分细节（如具体收费、价格、平台限制）资料未提供。