CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

himalaya

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/himalaya/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 highly actionable, token-efficient CLI cookbook with real, well-signaled one-level-deep references. The main gaps are the missing validation checkpoints around destructive email operations (delete/move) and mild duplication between the inline config example and the configuration reference.

Suggestions

Add a validation checkpoint before destructive operations, e.g. "Read the message first (`himalaya message read 42`) to confirm the ID before `message delete`, since IDs are folder-relative."

Slim the inline TOML config to a minimal working example and defer the full options to references/configuration.md, linking it from the Configuration Setup section.

Weave reference pointers into their related sections (e.g. link message-composition.md from the Write/Reply sections) instead of only listing them in a top-level References section.

DimensionReasoningScore

Conciseness

The body is a lean command cookbook — one-line descriptions plus executable bash blocks — with no explanations of concepts Claude already knows. The one trimmable instance is the 22-line inline TOML config that substantially duplicates the dedicated references/configuration.md, keeping it at anchor 4 rather than 5.

4 / 5

Actionability

Every operation section provides copy-paste-ready commands (e.g. `himalaya message read 42`, `himalaya message move 42 "Archive"`), and the heredoc `template send` example is a complete, self-contained message. The examples cover the common cases comprehensively, matching the fully-executable anchor.

5 / 5

Workflow Clarity

Sections are clearly organized and the setup flow (prerequisites → wizard/manual config) is sequenced, but destructive operations (`message delete`, `message move`) include no validation or verification checkpoint (e.g. read-before-delete or dry-run confirmation), which the rubric explicitly caps at 3. The tip about message IDs being folder-relative is a partial safety note, not a validation step, so it does not lift the score to 4.

3 / 5

Progressive Disclosure

Good structure: clear section headers, a References section naming both real one-level-deep files (references/configuration.md, references/message-composition.md) with what each covers, and an inline pointer in Tips. Minor gaps: the Configuration Setup section inlines substantial config detail that the dedicated reference already carries, and the reference pointers are not placed contextually beside the sections they support.

4 / 5

Total

16

/

20

Passed

Description

71%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, specific description that enumerates concrete capabilities in third-person imperative style with good natural keywords. Its main weakness is the absence of any explicit 'when to use this' trigger clause, which both caps completeness and slightly raises routing ambiguity.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to read, reply to, forward, search, or organize emails (or 'check my mail/inbox') from the terminal."

Include common synonyms like "mail" and "inbox" in the trigger phrasing to broaden natural-term coverage.

Mention attachment handling in the capability list to close the minor coverage gap.

DimensionReasoningScore

Specificity

The description lists seven concrete actions — "list, read, write, reply, forward, search, and organize emails" — which is comprehensive coverage of an email CLI's capabilities, matching the anchor for multiple specific concrete actions. Anchor 4 ('minor gaps in coverage') fits less well since the action list is broader and more concrete than its three-action example.

5 / 5

Completeness

The "what" is clearly and specifically stated (manage emails via IMAP/SMTP with enumerated operations), but there is no "Use when..." clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is not a 4 because the "when" is entirely absent rather than merely implicit or under-specified.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "emails", "reply", "forward", "search", "organize", "from the terminal", "IMAP/SMTP". Common variations like "mail", "inbox", or "send email" are missing, so it falls just short of the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

The named tool (`himalaya`) plus the terminal-email niche with MML/IMAP/SMTP specifics makes it mostly distinct with only minor overlap risk against other mail-related skills. It is not a 5 because without any 'use when' trigger phrasing, a generic 'check my email' request could plausibly route elsewhere.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

Bitterbot-AI/bitterbot-desktop

Path

skills/himalaya/SKILL.md

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.