Content
76%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |