Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-calendar-agenda

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Google Calendar: Show upcoming events across all calendars.

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-calendar-agenda

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈20 tokens for metadata: the name and description. ≈330 when used: this file.

Description uses 1.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈81 characters, or 1.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

calendar +agenda

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The 'calendar +agenda' skill is a read-only utility designed to list Google Calendar events using the 'gws' CLI tool. The analysis found no evidence of malicious behavior, unauthorized command execution, or data exfiltration. The skill references a local shared configuration for authentication, following standard security practices. While the skill processes external calendar data which is a theoretical surface for indirect prompt injection, this is inherent to its core functionality and mitigated by its read-only nature.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws calendar +agenda --help"
  }
}
  • CLI
  • google-workspace
  • calendar
  • agenda
  • events
  • gws

README badge

README badge for googleworkspace/cli/gws-calendar-agenda

Lists upcoming events across all Google Calendars via the gws CLI tool, with filters for date range, specific calendars, and timezone overrides. Use this to view your agenda for today, a specific number of days ahead, or the current week—read-only, never modifies events.

Generated from the current SKILL.md.

Does this skill modify any events?
No. The skill is read-only and only displays upcoming events across your calendars.
Can I filter events to a specific calendar?
Yes, use the --calendar flag with a calendar name or ID to show events from only that calendar.
What timezone does this use by default?
It defaults to your Google account timezone, but you can override it with the --timezone flag using an IANA timezone string (e.g. America/Denver).
What authentication is required?
You must set up Google Workspace auth via the gws-shared skill, which provides the underlying gws CLI tool and credentials.

Generated from the current SKILL.md. These answers refresh after source changes.