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 that users might naturally use when requesting this functionality.
Suggestions
Add a 'Use when...' clause such as '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 'sort messages' 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 | Clearly answers 'what' (apply labels and archive matching messages), but lacks an 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', 'archive', and 'inbox' creates a clear, unique identity. | 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.
This is a lean, actionable recipe that provides concrete CLI commands for a straightforward Gmail workflow. Its main weakness is the lack of validation steps or batch handling guidance—there's no mention of how to handle multiple matching messages, verify label application succeeded, or recover from errors. The conciseness and actionability are excellent.
Suggestions
Add a brief note on iterating over multiple message results from step 1 (e.g., looping over returned message IDs for steps 2-3).
Add a verification step after archiving, such as re-listing inbox messages or checking the label was applied, to create a feedback loop.
| 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 | Each step provides a fully concrete, copy-paste-ready CLI command with specific parameters. Placeholder values (MESSAGE_ID, LABEL_ID) are clearly identifiable and the commands are executable. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (search → label → archive), but there's no validation checkpoint or feedback loop. For batch operations on multiple messages, there's no guidance on iterating over results or verifying success, and no error handling for missing labels or invalid message IDs. | 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 | |
c7c6646
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.