plugins/google-workspace-cli/skills/calendar/SKILL.md
Use this skill when the user asks about managing Google Calendar events, checking schedules, creating meetings, finding free time, or any calendar-related task via the Google Workspace CLI.
npx skillsauth add nsheaps/ai-mktpl calendarInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use gws calendar to manage calendars and events from the command line.
# List all calendars
gws calendar list
# List with details
gws calendar list --format json
# View upcoming events (default: today)
gws calendar events
# View events for the next N days
gws calendar events --days 7
# View events with limit
gws calendar events --days 14 --limit 20
# View events for a specific calendar
gws calendar events --calendar "Work"
# View a specific event
gws calendar event <event-id>
# Search events by text
gws calendar search "team meeting"
# Search within a date range
gws calendar search "standup" --after "2026-03-01" --before "2026-03-31"
# Create a simple event
gws calendar create "Team Meeting" \
--start "2026-03-15 10:00" \
--end "2026-03-15 11:00"
# Create with attendees
gws calendar create "Project Review" \
--start "2026-03-15 14:00" \
--end "2026-03-15 15:00" \
--attendees "[email protected],[email protected]"
# Create with location and description
gws calendar create "Offsite" \
--start "2026-03-20 09:00" \
--end "2026-03-20 17:00" \
--location "Conference Room A" \
--description "Quarterly planning session"
# Create an all-day event
gws calendar create "Company Holiday" \
--date "2026-03-25" \
--all-day
# Create on a specific calendar
gws calendar create "Personal Errand" \
--start "2026-03-15 12:00" \
--end "2026-03-15 13:00" \
--calendar "Personal"
# Update event time
gws calendar update <event-id> \
--start "2026-03-15 11:00" \
--end "2026-03-15 12:00"
# Add attendees
gws calendar update <event-id> \
--add-attendees "[email protected]"
# Delete an event
gws calendar delete <event-id>
# Accept an event
gws calendar respond <event-id> --accept
# Decline an event
gws calendar respond <event-id> --decline
# Tentatively accept
gws calendar respond <event-id> --tentative
# Find free time slots
gws calendar free --days 5
# Find free time for multiple people
gws calendar free \
--attendees "[email protected],[email protected]" \
--duration 60 \
--days 5
The CLI accepts flexible date/time formats:
"2026-03-15 10:00" - Specific date and time"2026-03-15" - Date only (for all-day events)"tomorrow 10:00" - Relative dates"next monday 14:00" - Named days# Get events as JSON for processing
gws calendar events --format json | jq '.[].summary'
tools
Manually reproduce what the github-app plugin's SessionStart hook does to make a GitHub App installation token usable in the current session — materialize the PEM, generate the token, isolate GH_CONFIG_DIR, write the runtime env file, and wire CLAUDE_ENV_FILE so every Bash call sees GH_TOKEN/GITHUB_TOKEN. Use when the hook did not run, the token is missing from the environment, or a shell/teammate needs the token wired up by hand. <example>GH_TOKEN isn't set even though github-app is configured</example> <example>the github-app SessionStart hook didn't run, set up the token manually</example> <example>wire the github app token into CLAUDE_ENV_FILE</example> <example>gh keeps falling back to the wrong account, isolate GH_CONFIG_DIR</example>
tools
Manually configure the GitHub App bot git identity the way the github-app plugin's SessionStart hook does — resolve the app slug and bot user ID, build the <slug>[bot] name and noreply email, set GIT_AUTHOR_*/GIT_COMMITTER_* env vars, and write an isolated GIT_CONFIG_GLOBAL with the gh auth git-credential helper. Use when commits are attributed to the wrong account, "Author identity unknown" appears, or git identity must be set up by hand. <example>my commits are showing up as the handler, not the bot</example> <example>git says Author identity unknown after the github-app hook ran</example> <example>configure the github app bot git identity manually</example> <example>set up the gh credential helper for git push</example>
tools
Manages spec files for requirements capture and validation
tools
# Bash Chaining Alternatives This skill teaches you how to work around the bash command chaining restriction enforced by this plugin. ## Why Chaining is Blocked The `bash-command-rejection` plugin blocks these operators: | Operator | Name | Why Blocked | | -------- | ---------- | ----------------------------------------------------------------------------------- | | `&&` | AND chain | Runs cmd2 only if cmd1 su