gws-calendar-insert
Google Calendar: Create a new event.
72
66%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/gws-calendar-insert/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is extremely terse—it identifies the platform and a single action but lacks trigger guidance, natural keyword variations, and detail about capabilities. It would be difficult for Claude to reliably select this skill over similar calendar or scheduling skills in a large skill library.
Suggestions
Add an explicit 'Use when...' clause with trigger terms like 'schedule a meeting', 'add to calendar', 'book a time', 'appointment', or 'calendar invite'.
Expand the capability description to include specifics such as setting event time, location, attendees, recurrence, reminders, or descriptions.
Include natural keyword variations users might say, such as 'Google Calendar event', 'gcal', 'schedule', 'meeting invite', to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Google Calendar) and one specific action (create a new event), but does not list multiple concrete actions or elaborate on capabilities like setting reminders, inviting attendees, or specifying recurrence. | 2 / 3 |
Completeness | States what it does (create a new event on Google Calendar) but completely lacks a 'Use when...' clause or any explicit trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also minimal, warranting a score of 1. | 1 / 3 |
Trigger Term Quality | Includes 'Google Calendar' and 'event' which are natural terms users might say, but misses common variations like 'schedule a meeting', 'add to calendar', 'book a time slot', 'appointment', or 'calendar invite'. | 2 / 3 |
Distinctiveness Conflict Risk | Specifying 'Google Calendar' and 'create a new event' provides some distinctiveness, but it could overlap with other calendar-related skills or general Google Workspace skills without clearer trigger boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted, concise skill that provides everything needed to create a Google Calendar event via the CLI. It efficiently uses a flags table, concrete examples, and appropriate cross-references. The caution about write operations and user confirmation is a good safety practice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section serves a purpose—flags table, examples, and tips are all necessary for using the command. No unnecessary explanations of what calendars or events are. | 3 / 3 |
Actionability | Provides fully concrete, copy-paste ready bash commands with specific flag usage. The flags table clearly documents required vs optional parameters with format examples. The examples show real invocations. | 3 / 3 |
Workflow Clarity | This is a single-command skill, so complex multi-step workflows aren't needed. The caution box about confirming with the user before executing serves as an appropriate validation checkpoint for a write operation. The usage pattern is unambiguous. | 3 / 3 |
Progressive Disclosure | Appropriately references the shared skill file for auth and global flags via prerequisite note, and links to related skills in 'See Also'. Content is well-structured with clear sections and doesn't inline content that belongs elsewhere. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
- Repository
- googleworkspace/cli
- Commit
a3768d0
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.