recipe-send-team-announcement
Send a team announcement via both Gmail and a Google Chat space.
67
60%
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/recipe-send-team-announcement/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 concise and identifies a specific cross-platform action (sending announcements via Gmail and Google Chat), which gives it reasonable specificity. However, it lacks an explicit 'Use when...' clause, reducing its completeness, and it could benefit from additional trigger terms and variations to improve discoverability among many skills.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to broadcast a message, send a team announcement, or notify a group via email and chat simultaneously.'
Include additional trigger term variations such as 'email', 'broadcast', 'notify team', 'group message', 'Google Workspace', and 'chat notification'.
Consider listing additional concrete capabilities if the skill supports them, such as formatting the announcement, attaching files, or targeting specific chat spaces.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Gmail and Google Chat) and a specific action (send a team announcement), but only describes a single action rather than listing multiple concrete capabilities. | 2 / 3 |
Completeness | Describes what the skill does but has no explicit 'Use when...' clause or equivalent trigger guidance, and per the rubric a missing 'Use when' clause caps completeness at 2—but here the 'when' is entirely absent, warranting a 1. | 1 / 3 |
Trigger Term Quality | Includes natural keywords like 'Gmail', 'Google Chat space', 'team announcement', but misses common variations such as 'email', 'chat message', 'broadcast', 'notify team', or 'group message'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of Gmail and Google Chat space for announcements is somewhat distinctive, but could overlap with general Gmail-sending skills or Google Chat skills individually. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a concise, well-structured recipe skill that provides clear, actionable commands for a two-step workflow. Its main weakness is the lack of any validation or error-handling guidance between the two send operations, which matters since sending to the wrong audience or a failed send could have consequences.
Suggestions
Add a brief note about verifying the email was sent successfully before posting to Chat (e.g., check for confirmation output from the gmail send command).
Consider noting what to do if one of the two steps fails—should the other still proceed?
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Very lean and efficient. No unnecessary explanations of what Gmail or Google Chat are. Every line serves a purpose. | 3 / 3 |
Actionability | Provides fully concrete, copy-paste ready commands with specific flags, arguments, and example values for both steps. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced, but there's no validation or error handling—e.g., what if the email send fails? Should the Chat message still be posted? No feedback loop or checkpoint between the two steps. | 2 / 3 |
Progressive Disclosure | For a simple two-step skill under 50 lines, the structure is appropriate. It clearly references prerequisite skills for deeper details, keeping the recipe itself focused. | 3 / 3 |
Total | 11 / 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
c7c6646
- 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.