jholhewresjholhewres/devclaw-skills/skills/google-calendar/SKILL.md

google-calendar

Skill4 starsChanged 9 months agoMITView on GitHub

Google Calendar — list, create, and manage events via gcal CLI

Installs packages

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

0
Common
Most of the 19 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Create a project (or select existing)
line 26
Distinctive:
Always confirm with the user before creating or deleting events.
line 125
Distinctive:
Use the user's timezone (from config or system).
line 127
Distinctive:
When listing events, show: title, date/time, duration, location.
line 129

“Common” is measured: kept by at least 6 in 10 of the 19 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Google Calendar

Manage Google Calendar events from the command line using gcal (Node.js) or gcalcli (Python).

Setup (gcal — recommended)

1. Install

sudo npm install -g gcal

2. Create Google OAuth credentials

Go to https://console.cloud.google.com/apis/credentials
Create a project (or select existing)
Enable Google Calendar API: https://console.cloud.google.com/apis/library/calendar-json.googleapis.com
Go to Credentials → Create Credentials → OAuth client ID
Application type: Desktop app (or "Other")
Download the JSON file
Save as ~/.client_secret.json

3. Authorize (one-time)

# Generate authorization URL
gcal generateUrl

# Open the URL in your browser, authorize, and copy the code
gcal storeToken CODE_FROM_BROWSER

The token is saved at ~/calendar_api_token.json with auto-refresh.

Usage

List events

# Today's events
gcal list

# Tomorrow
gcal list tomorrow

# Date range (natural language)
gcal list 'from Monday to Friday'
gcal list 'from 03/01/2026 to 03/07/2026'

# Specific dates
gcal list -f 2026-02-14 -t 2026-02-21

Create events

# Natural language (preferred)
gcal insert 'Meeting with João tomorrow from 3pm to 4pm'
gcal insert 'Lunch on Friday at noon for 1 hour'
gcal insert 'Dentist appointment March 5 at 10am'

# Explicit parameters
gcal insert -s 'Team standup' -d 2026-02-15 -t 09:00 -D 30m
gcal insert -s 'Workshop' -d 2026-02-20 -t 14:00 -D 2h

Bulk insert (from JSON)

cat > /tmp/events.json << 'EOF'
[{
  "calendarId": "primary",
  "resource": {
    "summary": "Sprint planning",
    "start": { "dateTime": "2026-02-17T10:00:00" },
    "end": { "dateTime": "2026-02-17T11:00:00" }
  }
}, {
  "calendarId": "primary",
  "resource": {
    "summary": "Retrospective",
    "start": { "dateTime": "2026-02-17T14:00:00" },
    "end": { "dateTime": "2026-02-17T15:00:00" }
  }
}]
EOF
gcal bulk -e /tmp/events.json

Alternative: gcalcli (Python)

Install

pip install gcalcli

Usage

# List events
gcalcli agenda
gcalcli agenda --nostarted "2026-02-14" "2026-02-21"

# Create event
gcalcli quick "Meeting with team tomorrow 3pm 1hr"
gcalcli add --title "Meeting" --where "Room 1" --when "tomorrow 3pm" --duration 60

# Calendar view
gcalcli calw 2

Tips

Always confirm with the user before creating or deleting events.
Parse natural language dates (e.g., "tomorrow", "next Monday", "in 2 hours"; Portuguese: "amanhã", "próxima segunda", "daqui a 2 horas").
Use the user's timezone (from config or system).
For recurring events, mention the recurrence pattern to the user.
When listing events, show: title, date/time, duration, location.
gcal insert with natural language is the fastest way to create events.
Token auto-refreshes — no need to re-authorize after initial setup.

Triggers

calendar, what's on my calendar, schedule a meeting, create an event, check my schedule, free time, available, minha agenda, agendar, marcar reunião, calendário, próximos compromissos, google calendar

Download now (ZIP)

Other versions22 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 22
Lilac-Labs/gini-agent★ 1.9ksame name
Open-Curiosity/gini-agent★ 1.9ksame name
vellum-ai/vellum-assistant★ 1.5ksame name
gemini-cli-extensions/workspace★ 646same name
greatSumini/cc-system★ 438same name
sanjay3290/ai-skills★ 424same name
refly-ai/refly-skills★ 203same name
runxhq/runx★ 97same name
marswaveai/skills★ 79same name
ShaunTsai/skill-google-calendar★ 22same name
12 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use google-chat, google-sheets and 6 more.
Other files people use alongside this one.
- pbc-osSkill
  google-chat
  Google Chat messaging for small business teams. Send messages, post automated updates, manage spaces, run daily standups, and coordinate your team. Built on the gws CLI.
  Also in 3 projects that use this
- OpenAISkill
  google-sheets
  Analyze and edit connected Google Sheets with range precision. Use when the user wants to create Google Sheets, find a spreadsheet, inspect tabs or ranges, search rows, plan formulas, create or repair charts, clean or restructure tables, write concise summaries, or make explicit cell-range updates.
  Also in 9 projects that use this
- OpenAISkill
  google-docs
  Prompt- and template-complete Google Docs creation and editing with explicit-instruction-authoritative structural preservation, including semantic roles, relationships, comparison dimensions, and instructed extensions; full-topology native-copy routing; source-grounded per-tab adaptation for past/example references; style-preserving hyperlink and table edits; canonical smart-chip-first authoring for dates and relevant supported people or Google resources; a file-backed advisory trusted read before existing-document writes; automatic protected-control awareness; direct connector APIs by default; DOCX-first import only when no supplied Google Doc template/reference constrains the output; and checked-in code mode only for exact native dropdown mutation. Use when Codex must create, edit, fill, adapt, redesign, or verify Google Docs without overriding explicit user/template instructions, adding unrequested document scope, or carrying stale reference facts into a new deliverable.
  Also in 7 projects that use this
- clearsmogSkill
  google-tasks
  Manage Google Tasks via the `gtasks` CLI. Use when the user asks to view, add, update, complete, or delete tasks. Supports multiple task lists.
  Also in 3 projects that use this
- leolionartSkill
  google-gmail
  Operate Gmail via the Google Workspace CLI (gws) — send emails, reply with threading, triage inbox, and stream new messages as NDJSON. Use when users ask to send/forward/reply emails, check inbox summary, or automate email workflows.
  Also in 3 projects that use this
- ReScienceLabSkill
  reddit
  Search and retrieve content from Reddit. Get posts, comments, subreddit info, and user profiles via the public JSON API. Use when user mentions Reddit, a subreddit, or r/ links.
  Also in 3 projects that use this
- +2 more from openai
In this repository83 other files it gives its agents.
- a11y-axeSkill
- airtableSkill
- asanaSkill
- audio-ttsSkill
- aws-cliSkill
- azure-cliSkill
- backupSkill
- bookmarksSkill
- browser-automationSkill
- bundler-analyzeSkill
- calculatorSkill
- calendarSkill
- cargoSkill
- changelog-genSkill
- claude-codeSkill
- clickupSkill
- color-contrastSkill
- crypto-walletSkill
- databaseSkill
- discordSkill
- docker-composeSkill
- dockerSkill
- dora-metricsSkill
- emailSkill
- ffmpegSkill
- filesystemSkill
- gcloudSkill
- githubSkill
- gmailSkill
- gogSkill
- habitsSkill
- healthSkill
- hubspotSkill
- image-genSkill
- imagemagickSkill
- image-toolsSkill
- jiraSkill
- journalSkill
- kubernetesSkill
- lighthouseSkill
- linearSkill
- locationSkill
- media-configSkill
- meeting-notesSkill
- nginxSkill
- notesSkill
- notionSkill
- obsidianSkill
- ocrSkill
- pandocSkill
- paymentsSkill
- pdf-toolsSkill
- pip-poetrySkill
- pm2Skill
- pomodoroSkill
- project-managerSkill
- qr-codeSkill
- railway-deploySkill
- redis-cliSkill
- release-notesSkill
- The first 60 shown.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

Google Calendar

Setup (gcal — recommended)

1. Install

2. Create Google OAuth credentials

3. Authorize (one-time)

Usage

List events

Create events

Bulk insert (from JSON)

Alternative: gcalcli (Python)

Install

Usage

Tips

Triggers

Word for word · 0

Edited · 0

Wrote their own version · 22

google-chat

google-sheets

google-docs

google-tasks

google-gmail

reddit

Does it work?

No reviews yet

Your trail

Now do this for your own.