Apply Gmail labels to matching messages and archive them to keep your inbox clean.
77
72%
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-label-and-archive-emails/SKILL.mdQuality
Discovery
57%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 clearly scoped to Gmail label management and archiving, making it distinctive. However, it lacks an explicit 'Use when...' clause and could benefit from additional trigger terms covering common user phrasings like 'organize email' or 'filter messages'.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to organize Gmail, apply labels, filter messages, or clean up their inbox.'
Include additional natural trigger terms like 'email', 'filter', 'organize', 'categorize', or 'clean up inbox' to improve keyword coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Gmail) and two specific actions (apply labels, archive messages), but doesn't elaborate on additional capabilities like filtering criteria, bulk operations, or label management. | 2 / 3 |
Completeness | The 'what' is reasonably clear (apply labels and archive messages), but there is no explicit 'Use when...' clause or equivalent trigger guidance, which caps this at 2 per the rubric guidelines. | 2 / 3 |
Trigger Term Quality | Includes natural keywords like 'Gmail', 'labels', 'archive', and 'inbox', which users might say. However, it misses common variations like 'email', 'filter', 'organize', 'categorize', or 'clean up inbox'. | 2 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to Gmail labeling and archiving, which is a distinct niche unlikely to conflict with other skills. The combination of 'Gmail labels' and 'archive' creates a clear, specific trigger. | 3 / 3 |
Total | 9 / 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.
A lean, actionable recipe that provides concrete CLI commands for labeling and archiving Gmail messages. Its main weakness is the lack of validation steps or iteration guidance for batch operations—there's no mention of how to handle multiple matching messages from step 1 or verify that modifications succeeded.
Suggestions
Add a brief note on iterating over multiple message results from the search step (e.g., looping over returned message IDs).
Include a validation step such as re-listing messages or checking the response status after modify operations to confirm success.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose. No unnecessary explanations of what Gmail labels are or how archiving works. The prerequisite note is minimal and necessary. | 3 / 3 |
Actionability | Provides fully concrete, copy-paste-ready CLI commands for each step with specific parameters and JSON payloads. The only placeholders (MESSAGE_ID, LABEL_ID) are context-dependent and unavoidable. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced, but there are no validation checkpoints or feedback loops. For batch operations (applying labels to multiple matching messages), there's no guidance on iterating over results or verifying success, and no error handling for cases like invalid LABEL_ID. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines, the content is well-organized with a clear prerequisite callout, description, and numbered steps. No need for external references given the scope. | 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 | |
a3768d0
Table of Contents
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.