Name: welcome-to-superhuman-mail
Rating: 67.2 (1 reviews)
Author: superhuman

welcome-to-superhuman-mail

Welcome and onboard a new user to Superhuman Mail MCP. Use when the user is new to Superhuman Mail, asks what Superhuman Mail can do, wants a guided tour, setup walkthrough, first actions, examples for email or calendar workflows, help adding accounts, client-specific tool approval settings, Gmail/Outlook/app options, or says they want to get started with Superhuman Mail.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/welcome-to-superhuman-mail/SKILL.md

Quality

Content

75%Weight 40%Scale 1-5

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

A well-structured, choice-driven onboarding script with concrete prompts, named tools, and appropriate safety checkpoints. It is held at 4s by repeated menu-restatement, a few vague tool references, and a longer-than-necessary single-file layout.

Suggestions

State the 'show the onboarding menu again' loop once near the top and stop repeating it per section to tighten conciseness.

Name the exact drafting, query/search, and calendar tool identifiers (as done for `add_account`) instead of referring to 'the tool available in the client'.

Move the Gmail/Outlook settings detail and video tutorial link into a short reference file to keep the main flow lean and improve progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is directive and assumes Claude's competence without explaining known concepts, but 'show the onboarding menu again' is repeated at the end of nearly every section and could be consolidated once. Fits anchor 4 (efficient with minor trims) rather than 5.	4 / 5
Actionability	It gives concrete guidance — the named `add_account` tool, blockquote example prompts, and exact settings URLs — but several tool references stay vague ('use the Superhuman Mail drafting/query/calendar tool available in the client'), leaving minor gaps. Anchor 4.	4 / 5
Workflow Clarity	A clear menu-driven sequence (open → choose → act → re-present menu → close) with safety checkpoints ('Never send without explicit approval', confirm details before calendar events); however there are no explicit error-recovery feedback loops, capping it at anchor 4 rather than 5.	4 / 5
Progressive Disclosure	No bundle files exist and the body is a single well-organized document with clear section headers, but at ~117 lines it exceeds the 'under 50 lines' simple-skill exception and some peripheral content (Gmail/Outlook settings detail, video tutorial link) could be split out. Anchor 4.	4 / 5
	Total	16 / 20 Passed

Description

85%Weight 40%Scale 1-5

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 strong, trigger-rich description that clearly answers what and when for a distinct product niche. Its only weakness is that the 'what' under-specifies the concrete onboarding actions, leaving the capability list implicit in the trigger clause.

Suggestions

Promote 2-3 concrete onboarding actions into the 'what' clause (e.g., 'guide the user through adding accounts, drafting emails, searching their inbox, and creating calendar events') so specificity matches the trigger coverage.

Dimension	Reasoning	Score
Specificity	The 'what' is reduced to 'Welcome and onboard a new user to Superhuman Mail MCP' — it names the domain with two high-level actions, but the actual capability breadth (search, draft, calendar, accounts, settings) is not stated as concrete actions. Fits anchor 2 ('Names the domain but actions are minimal or generic') rather than 3, since the concrete action list is not comprehensive.	2 / 5
Completeness	It explicitly answers both 'what' (welcome and onboard a new user) and 'when' via a detailed 'Use when…' clause with concrete trigger phrases, matching anchor 5; the explicit trigger guidance means no 3-cap applies.	5 / 5
Trigger Term Quality	The 'Use when…' clause packs in many natural phrases a user would actually say — 'what Superhuman Mail can do', 'guided tour', 'setup walkthrough', 'get started', 'first actions', 'help adding accounts' — with strong synonym coverage, matching the comprehensive anchor 5.	5 / 5
Distinctiveness Conflict Risk	It targets a specific named product (Superhuman Mail) with onboarding-specific triggers, giving it a clear niche with minimal overlap risk against other skills, matching anchor 5.	5 / 5
	Total	17 / 20 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: superhuman/mcp-mail
Path: skills/welcome-to-superhuman-mail/SKILL.md
Commit: a83580e

Reviewed: 2 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.