← Back to Skills Marketplace
Calendar Query
by
Matt Williams
· GitHub ↗
· v1.0.0
· MIT-0
116
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install calendar-query
Description
Query Matt's calendars with the gog CLI. Always prioritize the Flowcode work calendar ([email protected]) and include personal calendar (williams.e....
README (SKILL.md)
Calendar Query Skill
Use the gog CLI (already authenticated as [email protected]) to read Matt's calendars. Always follow this order:
- Work calendar first — [email protected]
- Personal calendar as aside — [email protected] (summaries, FYIs)
Commands
List events for a specific day
gog calendar events \x3Ccalendar_id> --from "YYYY-MM-DDT00:00:00" --to "YYYY-MM-DDT23:59:59"
- Example (work calendar tomorrow):
gog calendar events [email protected] --from "2026-03-18T00:00:00" --to "2026-03-18T23:59:59"
Relative ranges
--tomorrow,--today,--days N,--week- Example: next 7 days on personal calendar
gog calendar events [email protected] --days 7
Keyword search
gog calendar events \x3Ccalendar_id> --query "keyword" --from \x3Cstart> --to \x3Cend>
Use for finding Bulls games, travel, etc.
Multiple calendars at once
Use separate commands per calendar and merge results in your reply.
Response Pattern
- Summarize work calendar events chronologically (time + title + context).
- Add personal calendar notes afterward if relevant ("On personal calendar: ...").
- Mention all-day events clearly.
Tips
- Use ISO timestamps;
--from/--toare required for single-day accuracy. - For afternoon-specific questions, query narrowed windows (
--from "2026-03-24T12:00:00"). - When unsure about date, confirm with the user.
- If
gogerrors, include the error message and suggest retrying or re-authenticating.
Usage Guidance
This skill will run 'gog' CLI commands to read two specific calendars (work and personal). Before installing or enabling it: 1) Confirm whether your agent environment actually has the 'gog' binary installed and authenticated as the named bot ([email protected]). The manifest currently fails to declare that dependency. 2) Decide whether you want a skill that can read both a work and a personal calendar—this exposes personal schedule details; if not, request a version limited to the work calendar only. 3) Ask the skill author to declare required binaries and how authentication is supplied (env vars, config path, or interactive auth) and to document consent/ownership of the calendars referenced. 4) If you don't control or trust the pre-authenticated account, do not enable the skill because it could leak private calendar data. 5) If you proceed, run the skill in a controlled environment first and verify the exact commands it executes and the outputs it returns.
Capability Assessment
Purpose & Capability
The skill's name and description say it will query calendars using the 'gog' CLI and prioritize two specific calendar accounts, which is consistent with the stated purpose. However, the skill metadata lists no required binaries, no primary credential, and no config paths even though the runtime instructions explicitly require the 'gog' CLI and assume it is authenticated as [email protected]. This mismatch (declaring no dependencies while requiring a CLI and authenticated account) is incoherent and should be clarified.
Instruction Scope
SKILL.md instructs the agent to run concrete 'gog calendar events' commands against two specific email-address calendars (work and personal) and to merge results. That behavior is in-scope for a calendar-query skill. The concern is that it explicitly instructs use of an account ([email protected]) and to surface personal calendar details ([email protected]) without documenting how those credentials/authorizations are provided or whether the user consents to exposing personal calendar contents. This is a privacy and authorization gap.
Install Mechanism
There is no install spec (instruction-only), which is low-risk from a code installation standpoint. However, the runtime plainly requires the 'gog' CLI to be present and authenticated — yet the manifest doesn't declare that binary as required. The lack of a declared dependency means the consumer may not realize the environment must provide and authorize that CLI beforehand.
Credentials
The skill accesses potentially sensitive personal data (a work calendar and a personal Gmail calendar) but declares no credentials, no env vars, and no config paths. It assumes a pre-authenticated bot account is available. Requesting access to both work and personal calendars is reasonable for a calendar skill, but the absence of explicit credential/config requirements and the inclusion of full email addresses in the instructions are disproportionate without an explanation of how access is provisioned and consented to.
Persistence & Privilege
The skill does not request permanent presence (always:false), does not include an install script, and does not claim to modify other skills or global agent settings. It does not request elevated system privileges in the manifest.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install calendar-query - After installation, invoke the skill by name or use
/calendar-query - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with calendar query capabilities:
- Enables querying Matt's work (Flowcode) and personal Google calendars using the gog CLI.
- Prioritizes events from the Flowcode work calendar, with personal calendar notes added as relevant.
- Supports listing events by day, week, custom ranges, and keyword search.
- Provides guidance on formatting queries, handling errors, and summarizing responses.
Metadata
Frequently Asked Questions
What is Calendar Query?
Query Matt's calendars with the gog CLI. Always prioritize the Flowcode work calendar ([email protected]) and include personal calendar (williams.e.... It is an AI Agent Skill for Claude Code / OpenClaw, with 116 downloads so far.
How do I install Calendar Query?
Run "/install calendar-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Calendar Query free?
Yes, Calendar Query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Calendar Query support?
Calendar Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Calendar Query?
It is built and maintained by Matt Williams (@williamsmatt); the current version is v1.0.0.
More Skills