← 返回 Skills 市场
Gws Calendar Agenda
作者
googleworkspace-bot
· GitHub ↗
· v1.0.13
· MIT-0
839
总下载
0
收藏
18
当前安装
14
版本数
在 OpenClaw 中安装
/install gws-calendar-agenda
功能描述
Google Calendar: Show upcoming events across all calendars.
使用说明 (SKILL.md)
calendar +agenda
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Show upcoming events across all calendars
Usage
gws calendar +agenda
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--today |
— | — | Show today's events |
--tomorrow |
— | — | Show tomorrow's events |
--week |
— | — | Show this week's events |
--days |
— | — | Number of days ahead to show |
--calendar |
— | — | Filter to specific calendar name or ID |
--timezone |
— | — | IANA timezone override (e.g. America/Denver). Defaults to Google account timezone. |
Examples
gws calendar +agenda
gws calendar +agenda --today
gws calendar +agenda --week --format table
gws calendar +agenda --days 3 --calendar 'Work'
gws calendar +agenda --today --timezone America/New_York
Tips
- Read-only — never modifies events.
- Queries all calendars by default; use --calendar to filter.
- Uses your Google account timezone by default; override with --timezone.
See Also
- gws-shared — Global flags and auth
- gws-calendar — All manage calendars and events commands
安全使用建议
This skill appears to be a thin wrapper around the 'gws' CLI to read Google Calendar events, which is reasonable — but it defers authentication details to a sibling file (../gws-shared/SKILL.md) and suggests running 'gws generate-skills' to create that file. Before installing or invoking the skill: 1) Verify the origin and trustworthiness of the 'gws' binary (how will it be installed?). 2) Inspect ../gws-shared/SKILL.md (or the output of 'gws generate-skills') to see exactly what credentials, files, and filesystem locations are used and what OAuth scopes are requested. 3) Confirm whether credentials are stored locally (and where) or provided via environment variables; if stored, prefer isolated test environments. 4) If you don't want the agent creating files or running auth flows, do not allow it to run the generator and run the CLI manually yourself. If you provide those details, I can re-evaluate and raise confidence.
功能分析
Type: OpenClaw Skill
Name: gws-calendar-agenda
Version: 1.0.13
The skill bundle provides standard instructions for an AI agent to interact with a Google Workspace CLI tool (gws) to list calendar events. The SKILL.md file defines legitimate flags and examples for viewing agendas, and there are no signs of malicious intent, data exfiltration, or prompt injection.
能力评估
Purpose & Capability
Name/description (Google Calendar agenda) align with the declared requirement: the skill is instruction-only and requires the 'gws' CLI to query calendars. Requiring a Google-related CLI is appropriate for this purpose.
Instruction Scope
The SKILL.md explicitly tells the agent to read ../gws-shared/SKILL.md for auth, global flags, and security rules and to run 'gws generate-skills' if that file is missing. That directs the agent to read or create files outside this skill's directory and to run a generator that may write config and trigger authentication flows. The skill does not detail what the shared file contains or what paths/credentials will be accessed or created.
Install Mechanism
No install spec and no code files — lowest-risk distribution. The skill relies on an existing 'gws' binary on PATH; installing that binary is outside this skill.
Credentials
The skill declares no required environment variables or primary credential, yet refers to a shared auth document and a CLI that will require Google credentials (OAuth tokens, service account keys, or local config). The lack of declared env vars/config paths is a transparency gap: users can't see what secrets or files the skill will actually need or access.
Persistence & Privilege
always:false and no explicit autonomous privilege escalation. However, the instruction to run 'gws generate-skills' if the shared SKILL.md is missing implies the agent may create files or config (persisted credentials) on disk. This is not inherently malicious but should be reviewed for where files are written and what scopes are requested.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gws-calendar-agenda - 安装完成后，直接呼叫该 Skill 的名称或使用
/gws-calendar-agenda触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.13
- Bumped skill version from 0.22.4 to 0.22.5 in SKILL.md.
v1.0.12
- Updated version number in SKILL.md from 0.22.3 to 0.22.4.
- No other content or feature changes.
v1.0.11
- Bumped metadata version from 0.22.2 to 0.22.3 in SKILL.md.
- No functional or documentation changes otherwise.
v1.0.10
- Updated version number in SKILL.md from 0.22.1 to 0.22.2.
- No feature or documentation changes; maintenance update only.
v1.0.9
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md.
- No functional changes; documentation only.
v1.0.8
- Updated version metadata in SKILL.md from 0.21.2 to 0.22.0.
- No functional or usage changes; documentation update only.
v1.0.7
- Bumped metadata version from 0.21.1 to 0.21.2 in SKILL.md.
- No changes to usage, flags, or documentation content.
v1.0.6
- Updated skill version in metadata from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.5
- Bumped metadata version from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.4
- Bumped skill version to 0.20.0 in metadata.
- No functional or usage changes.
- Documentation/metadata update only.
v1.0.3
- Updated version metadata to 0.19.0 to match new versioning scheme.
- Moved the version field from the root level to the "metadata" section in SKILL.md.
- No behavioral or flag changes; documentation only.
v1.0.2
- Documentation update only: formatting changes in SKILL.md
- No changes to functionality or usage
- Clarified YAML indentation under metadata > requires > bins section
v1.0.1
- Added support for a --timezone flag to override the default Google account timezone.
- Updated usage examples and tips to include and document the new --timezone option.
v1.0.0
Initial release: Display upcoming Google Calendar events across all calendars.
- Supports filtering events by today, tomorrow, this week, or a custom number of days ahead.
- Allows restricting results to a specific calendar by name or ID.
- Read-only; does not modify events.
- Usage instructions and command examples included for easy setup.
元数据
常见问题
Gws Calendar Agenda 是什么？
Google Calendar: Show upcoming events across all calendars. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 839 次。
如何安装 Gws Calendar Agenda？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-calendar-agenda」即可一键安装，无需额外配置。
Gws Calendar Agenda 是免费的吗？
是的，Gws Calendar Agenda 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Gws Calendar Agenda 支持哪些平台？
Gws Calendar Agenda 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Gws Calendar Agenda？
由 googleworkspace-bot（@googleworkspace-bot）开发并维护，当前版本 v1.0.13。
推荐 Skills