Name: apple-mail
Rating: 74.4 (1 reviews)
Author: mitsuhiko

apple-mail

Search, read, and extract attachments from Apple Mail's local storage. Query emails by sender, recipient, subject, body, date, mailbox, and flags. Read raw RFC822 messages and extract file attachments.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, highly actionable reference for a single read-only tool: copy-paste commands, a complete flag table, and documented output formats with no wasted tokens. Structure is clean and self-contained, requiring no external references.

Dimension	Reasoning	Score
Conciseness	Lean and efficient — a copy-paste Quick Reference, a compact flag table, output-format spec, and terse Notes — with no padding or explanation of concepts Claude already knows, matching the 'every token earns its place' anchor.	3 / 3
Actionability	Fully executable, copy-paste-ready commands with real arguments ('search --from "peter@" --subject "dinner" --limit 5', 'read 783660', 'attachment 783660 "Rechnung.pdf"') plus a complete flag table and documented output, matching the top anchor.	3 / 3
Workflow Clarity	Each subcommand is self-contained and unambiguous, and the tool is explicitly read-only so the destructive-operation validation cap does not apply; for a simple single-tool skill with clear, unambiguous actions this fits the top anchor per the simple-skills note.	3 / 3
Progressive Disclosure	Content is well-organized into clearly labeled sections (Tool, Quick Reference, Search Options, Output Format, Notes) with no nested references and no need for external bundle files, fitting the well-organized-sections top anchor for a compact self-contained skill.	3 / 3
	Total	12 / 12 Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, action-rich description with natural trigger terms and a clear niche, but it omits any explicit 'Use when...' guidance, which caps completeness at 2.

Suggestions

Add an explicit trigger clause, e.g. 'Use when searching or reading emails, or extracting attachments from Apple Mail on macOS.'

Include common user phrasings like 'find emails', 'open an email', or 'save attachments' to broaden natural trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Search, read, and extract attachments', 'Query emails by sender, recipient, subject, body, date, mailbox, and flags', 'Read raw RFC822 messages' — matching the top anchor for naming several specific actions.	3 / 3
Completeness	It clearly answers 'what' but provides no 'Use when...' clause or equivalent explicit trigger guidance, which the rubric caps at 2 ('Has what, but when is missing or only implied').	2 / 3
Trigger Term Quality	Natural terms a user would say are well covered — 'Apple Mail', 'emails', 'attachments', 'search', 'sender', 'subject' — rather than only technical jargon, fitting the 'good coverage of natural terms' anchor.	3 / 3
Distinctiveness Conflict Risk	'Apple Mail's local storage' is a clear, narrow niche with distinct triggers unlikely to conflict with other skills, matching the top anchor.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: mitsuhiko/agent-stuff
Path: skills/apple-mail/SKILL.md
Commit: d265b8e

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.