{"id":"138a7209-8763-442d-8fe1-540d6a689740","entityType":"agent","slug":"clawhub-bird-frank-himalaya-skill","name":"Himalaya","canonicalUrl":"https://www.xpersona.co/agent/clawhub-bird-frank-himalaya-skill","canonicalPath":"/agent/clawhub-bird-frank-himalaya-skill","generatedAt":"2026-10-11T20:59:21.530Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":null},"description":"Expert guidance for querying, writing, and managing emails using the `himalaya` CLI. Use this skill whenever the user wants to list emails, search envelopes,...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s178xp167x6qef16anv6t2zqfh83gha3:himalaya-skill","sourceUrl":"https://clawhub.ai/bird-frank/himalaya-skill","homepage":"https://clawhub.ai/bird-frank/skills/himalaya-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/bird-frank/himalaya-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/bird-frank/skills/himalaya-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Himalaya technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":null},"stars":null,"forks":null,"downloads":1017,"packageName":null,"latestVersion":"1.0.0","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:38:15.561Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T17:38:15.574Z","lastCrawledAt":"2026-10-11T17:38:15.561Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T17:38:15.561Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.0","createdAt":"2026-04-19T04:46:49.995Z","changelog":"himalaya-skill 1.0.0 - Initial release providing expert guidance for the Himalaya command-line email client. - Covers email listing, searching, composing, flag/folder management, attachments, and templates. - Includes full Query DSL reference, command patterns, and best CLI practices. - Triggers when users mention email CLI, terminal email, or the Himalaya client.","fileCount":5,"zipByteSize":9012}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178xp167x6qef16anv6t2zqfh83gha3:himalaya-skill","setupComplexity":"medium","setupSteps":["Install using `clawhub skill install s178xp167x6qef16anv6t2zqfh83gha3:himalaya-skill` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/bird-frank/himalaya-skill before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T20:59:21.529Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":null},"readme":"Skill: Himalaya\n\nOwner: bird-frank\n\nSummary: Expert guidance for querying, writing, and managing emails using the `himalaya` CLI. Use this skill whenever the user wants to list emails, search envelopes,...\n\nTags: latest:1.0.0\n\nVersion history:\n\nv1.0.0 | 2026-04-19T04:46:49.995Z | user\n\nhimalaya-skill 1.0.0\n\n- Initial release providing expert guidance for the Himalaya command-line email client.\n- Covers email listing, searching, composing, flag/folder management, attachments, and templates.\n- Includes full Query DSL reference, command patterns, and best CLI practices.\n- Triggers when users mention email CLI, terminal email, or the Himalaya client.\n\nArchive index:\n\nArchive v1.0.0: 5 files, 9012 bytes\n\nFiles: evals/evals.json (2427b), references/query_dsl.md (6999b), skill-card.md (1862b), SKILL.md (8366b), _meta.json (133b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: himalaya\ndescription: |\n Expert guidance for querying, writing, and managing emails using the `himalaya` CLI.\n Use this skill whenever the user wants to list emails, search envelopes, compose messages,\n manage flags/folders, or execute any himalaya command. Also trigger when the user mentions\n \"email CLI\", \"terminal email\", \"manage emails from command line\", or references the\n Himalaya mail client. This skill provides the full query DSL specification, command\n patterns, and best practices for the himalaya email CLI.\n---\n\n# Himalaya CLI Expert\n\nThis skill makes you an instant expert on the [Himalaya](https://github.com/pimalaya/himalaya)\ncommand-line email client. Himalaya is a stateless CLI (not a TUI) that lets users manage emails\nvia shell commands.\n\n## When this skill applies\n\nUse this skill for ANY task involving:\n- Listing, searching, or sorting emails (`himalaya envelope list|thread`)\n- Reading, writing, replying to, or forwarding messages (`himalaya message ...`)\n- Managing flags (`himalaya flag ...`)\n- Managing folders/mailboxes (`himalaya folder ...`)\n- Message templates and attachments (`himalaya template ...`, `himalaya attachment ...`)\n- Interpreting or constructing Himalaya query DSL strings\n\n## Architecture overview\n\nHimalaya CLI is organized around nouns:\n\n```\nhimalaya [args...]\n```\n\nKey nouns:\n- `envelope` (aliases: `envelopes`) — email envelopes (metadata, no body)\n- `message` (aliases: `msg`, `msgs`, `messages`) — full email messages\n- `flag` (aliases: `flags`) — message flags (seen, answered, flagged, deleted…)\n- `folder` (aliases: `folders`, `mailbox`, `mailboxes`, `mbox`, `mboxes`) — mailboxes\n- `template` (aliases: `tpl`, `tpls`, `templates`) — message templates\n- `attachment` (aliases: `attachments`) — message attachments\n- `account` (aliases: `accounts`) — account configuration\n\nGlobal flags (available on all commands):\n- `--config ` — override config file path\n- `--output json` / `--output plain` — choose output format\n- `--quiet`, `--debug`, `--trace` — logging levels\n\nCommon per-command flags:\n- `-a ` / `--account ` — target a specific configured account\n- `-f ` / `--folder ` — target a specific folder\n\n## Querying emails: envelope commands\n\nThe most common operation is listing envelopes. Read the full Query DSL reference\n(`references/query_dsl.md`) **whenever the user asks anything about search, filter, sort,\nor list queries**.\n\n### Essential commands\n\n```bash\n# List all envelopes in the default folder\nhimalaya envelope list\n\n# List envelopes in a specific folder, page 2, 20 per page\nhimalaya envelope list -f Archives.FOSS --page 2 --page-size 20\n\n# Thread view for envelopes matching a query\nhimalaya envelope thread subject \"product requirement\"\n```\n\n### Query DSL quick reference\n\nA query string has the form:\n\n```\n[filter-query] [order by sort-query]\n```\n\n**Filter conditions:**\n- `date ` — exact date match\n- `before ` — strictly before date\n- `after ` — strictly after date\n- `from ` — sender pattern match\n- `to ` — recipient pattern match\n- `subject ` — subject pattern match\n- `body ` — body text match (slower)\n- `flag ` — flag match (e.g., `seen`, `deleted`)\n\n**Operators (precedence: `not` > `and` > `or`):**\n- `not `\n- ` and `\n- ` or `\n\n**Sort query:**\n- `order by date [asc|desc]`\n- `order by from [asc|desc]`\n- `order by to [asc|desc]`\n- `order by subject [asc|desc]`\n- Multiple fields are allowed: `order by from asc date desc`\n\n**Quoting and escaping:**\n- Use double quotes for values containing spaces: `subject \"meeting notes\"`\n- Or escape with backslash: `subject meeting\\ notes`\n- In shell, the entire query may need to be passed as a single string or joined args.\n\n### Query examples (detailed)\n\n```bash\n# Unread emails, newest first\nhimalaya envelope list \"not flag seen order by date desc\"\n\n# From boss or CEO, sorted by date desc\nhimalaya envelope list \"from boss@example.com or from ceo@example.com order by date desc\"\n\n# Subject contains \"周报\" AND body contains \"进度\"\nhimalaya envelope list \"subject 周报 and body 进度\"\n\n# Date range: after March 31 and before April 11, 2025\nhimalaya envelope list \"after 2025-03-31 and before 2025-04-11\"\n\n# Complex grouped condition: (subject urgent OR body error) AND from ops\nhimalaya envelope list '(subject 紧急 or body 报错) and from ops@example.com'\n\n# Specific folder + pagination + query\nhimalaya envelope list -f INBOX --page 2 --page-size 20 'subject \"release plan\" order by date desc'\n```\n\n> **Performance tip**: Prefer `from`, `to`, `subject` over `body` because `body` triggers a\n> server-side full-text scan.\n\n> **Reference**: For the complete Query DSL specification, IMAP mapping, and compatibility\n> notes, read `references/query_dsl.md`.\n\n## Writing and sending emails: message commands\n\n### Composing a new message\n\nHimalaya uses your `$EDITOR` to compose messages from a template.\n\n```bash\n# Compose a new message interactively\nhimalaya message write\n\n# Pre-fill headers via CLI arguments\nhimalaya message write --to \"team@example.com\" --subject \"Sprint review\"\n\n# Compose using a saved template\nhimalaya message write --template /path/to/template.eml\n```\n\n### Reply and forward\n\n```bash\n# Reply to message ID 42\nhimalaya message reply 42\n\n# Reply-all\nhimalaya message reply 42 --all\n\n# Forward message ID 42\nhimalaya message forward 42 --to \"someone@example.com\"\n```\n\n### Reading, saving, and exporting\n\n```bash\n# Read raw message content\nhimalaya message read 42\n\n# Save message to local .eml file\nhimalaya message save 42 --path ./message42.eml\n\n# Export message(s)\nhimalaya message export 42 --path ./exports/\n```\n\n### Message template format\n\nA template is a set of headers followed by a blank line and then the body:\n\n```eml\nFrom: alice@example.com\nTo: Bob \nSubject: Hello from Himalaya\n\nHello, world!\n```\n\nValid headers include: `From`, `To`, `Cc`, `Bcc`, `Reply-To`, `Subject`, `Date`,\n`Message-ID`, `In-Reply-To`.\n\nAddresses can be:\n- Plain: `user@domain`\n- Named: `Name `\n- Quoted named: `\"Name\" `\n- Multiple addresses separated by commas.\n\n### Attachments\n\nAttachments are handled via the `attachment` noun or MML syntax in templates.\n\n```bash\n# Download attachments from message 42\nhimalaya attachment download 42 --path ./downloads/\n```\n\nMML attachment example inside a template body:\n\n```eml\nFrom: alice@example.com\nTo: bob@example.com\nSubject: Attaching a doc\n\n<#part filename=/path/to/file.pdf><#/part>\n```\n\n## Managing emails: flags and folders\n\n### Flags\n\n```bash\n# Add flag(s) to envelope(s)\nhimalaya flag add 42,43 flagged answered\n\n# Remove flag(s)\nhimalaya flag remove 42 flagged\n\n# Set exact flags (replaces existing)\nhimalaya flag set 42 seen\n```\n\nCommon flags: `seen`, `answered`, `flagged`, `deleted`, `draft`.\n\n### Folders\n\n```bash\n# List folders\nhimalaya folder list\n\n# Add a folder\nhimalaya folder add MyFolder\n\n# Delete a folder\nhimalaya folder delete MyFolder\n\n# Purge deleted messages from a folder\nhimalaya folder purge MyFolder\n\n# Expunge a folder\nhimalaya folder expunge MyFolder\n```\n\n## Multi-account workflows\n\nHimalaya supports multiple accounts via TOML config. Target a non-default account with `-a`:\n\n```bash\nhimalaya envelope list -a work -f INBOX\nhimalaya message write -a personal --to \"friend@example.com\"\n```\n\n## Output format tips\n\n- Use `--output json` when you need structured data for piping into `jq` or scripts.\n- Use `--output plain` (default) for human-readable tables and text.\n\n## Common gotchas\n\n1. **Trailing query args**: `himalaya envelope list` accepts the query as trailing arguments.\n Shell escaping matters. If the query has spaces, quote the entire query string.\n2. **Page numbering**: `--page` starts at 1 (not 0).\n3. **Date boundaries**: `before 2025-04-01` excludes April 1; `after 2025-04-01` also excludes\n April 1 (Himalaya adjusts internally by adding a day to use `SENTSINCE`).\n4. **Config location**: Default is `~/.config/himalaya/config.toml`. Run `himalaya account configure `\n for the wizard.\n\n## External resources\n\n- Repository: https://github.com/pimalaya/himalaya\n- Query DSL reference (bundled): `references/query_dsl.md`\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn792wn2t4x4kdq3j345twmwv182x5m7\",\n \"slug\": \"himalaya-skill\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1776574009995\n}\n\nFile v1.0.0:references/query_dsl.md\n\n# Himalaya 邮件查询使用指南\n\n## 概述\n\nHimalaya 的 `envelope list` 和 `envelope thread` 命令支持一套专门设计的查询 DSL（领域特定语言），用于**筛选**和**排序**邮件。你的查询字符串会被 Himalaya 解析成 AST，最终转换为 IMAP `SEARCH` / `SORT` 命令发送给邮件服务器。\n\n> **注意**：Himalaya 的查询语法是高层封装，并非直接使用 IMAP 原始关键字，但底层会映射为 IMAP 搜索条件。\n\n---\n\n## 查询语法结构\n\n一条完整查询由 **过滤条件** 和 **排序条件** 组成，两者可选：\n\n```\n[filter-query] [order by sort-query]\n```\n\n- `filter-query`：指定筛选条件（可选）\n- `sort-query`：指定排序规则（可选）\n- 若两者同时存在，**过滤条件必须写在 `order by` 前面**\n\n---\n\n## 过滤条件语法\n\n### 基本形式\n\n过滤条件由**条件**和**运算符**组合而成，支持使用括号 `()` 改变优先级。\n\n### 可用的条件\n\n| Himalaya 语法 | 含义 | 对应 IMAP 搜索键 | 示例 |\n|--------------|------|-----------------|------|\n| `date ` | 日期精确匹配 | `SENTON` | `date 2025-04-12` |\n| `before ` | 日期严格小于 | `SENTBEFORE` | `before 2025-04-01` |\n| `after ` | 日期严格大于 | `SENTSINCE` (+1天) | `after 2025-04-01` |\n| `from ` | 发件人匹配 | `FROM` | `from alice@example.com` |\n| `to ` | 收件人匹配 | `TO` | `to bob@example.com` |\n| `subject ` | 主题匹配 | `SUBJECT` | `subject \"会议通知\"` |\n| `body ` | 正文内容匹配 | `BODY` | `body 项目进度` |\n| `flag ` | 邮件标志匹配 | 对应状态标志 | `flag seen` |\n\n### 可用的运算符\n\n| 运算符 | 优先级 | 含义 | 示例 |\n|--------|--------|------|------|\n| `not` | 最高 | 取反 | `not from spam@example.com` |\n| `and` | 中 | 两者都必须满足 | `from boss and subject 周报` |\n| `or` | 最低 | 满足其一即可 | `from alice or from bob` |\n\n**优先级规则**：`not` > `and` > `or`，复杂查询建议用括号明确优先级。\n\n### 模式匹配中的空格与引号\n\n- **引号**：用双引号包裹含空格的字符串，如 `subject \"foo bar\"`\n- **转义**：无引号模式下可用反斜杠转义空格和括号，如 `subject foo\\ bar`\n- 引号内可转义 `\\\"` 和 `\\\\`\n\n---\n\n## 排序条件语法\n\n使用关键字 `order by` 开头，后跟一个或多个排序字段，每个字段可指定 `asc` 或 `desc`。\n\n### 可用的排序字段\n\n| 字段 | 排序依据 |\n|------|---------|\n| `date` | 邮件日期 |\n| `from` | 发件人 |\n| `to` | 收件人 |\n| `subject` | 主题 |\n\n### 默认顺序\n\n- 不指定时默认为 **升序** (`asc`)\n- 多字段排序时按声明顺序依次应用\n\n---\n\n## 组合查询示例\n\n### 纯过滤\n```bash\n# 主题包含\"周报\"且正文包含\"进度\"\nhimalaya envelope list subject 周报 and body 进度\n\n# 来自老板或 CEO 的邮件\nhimalaya envelope list from boss@example.com or from ceo@example.com\n\n# 不是已删除的邮件（假设服务器支持相关标志）\nhimalaya envelope list not flag deleted\n```\n\n### 纯排序\n```bash\n# 按日期降序排列（最新的在前）\nhimalaya envelope list order by date desc\n\n# 先按发件人升序，再按主题降序\nhimalaya envelope list order by from asc subject desc\n```\n\n### 过滤 + 排序\n```bash\n# 查找未读邮件，按日期降序排列\nhimalaya envelope list not flag seen order by date desc\n\n# 查找4月以来的重要邮件，先按发件人排序再按日期排序\nhimalaya envelope list after 2025-04-01 and subject 重要 order by from date desc\n```\n\n---\n\n## 常见场景命令示例\n\n### 1. 查看未读邮件\n```bash\nhimalaya envelope list not flag seen\nhimalaya envelope list not flag seen order by date desc\n```\n\n### 2. 查看来自特定发件人的邮件\n```bash\nhimaya envelope list from alice@example.com\nhimalaya envelope list from alice@example.com order by date desc\n```\n\n### 3. 按日期范围查找\n```bash\n# 2025年4月1日至4月10日（before 不包含边界）\nhimalaya envelope list after 2025-03-31 and before 2025-04-11\n\n# 2025年4月12日当天的邮件\nhimalaya envelope list date 2025-04-12\n```\n\n### 4. 主题搜索\n```bash\n# 简单关键词\nhimalaya envelope list subject 项目\n\n# 带空格的短语\nhimalaya envelope list subject \"会议通知\"\n\n# 转义空格（等效写法）\nhimalaya envelope list subject 会议\\ 通知\n```\n\n### 5. 复杂组合查询\n```bash\n# （主题含\"紧急\"或正文含\"报错\"）且来自运维组\nhimalaya envelope list \"(subject 紧急 or body 报错) and from ops@example.com\"\n\n# 来自老板且不是已读的\nhimalaya envelope list from boss@example.com and not flag seen\n```\n\n### 6. 分页浏览\n```bash\n# 每页 20 封，浏览第 2 页\nhimalaya envelope list --page 2 --page-size 20 subject 周报 order by date desc\n```\n\n### 7. 指定文件夹查询\n```bash\n# 在 Archives.FOSS 文件夹中查找\nhimalaya envelope list --folder Archives.FOSS from kernel.org\n```\n\n### 8. 线程视图\n```bash\n# 以线程形式查看包含某查询的邮件\nhimalaya envelope thread subject \"产品需求\"\n```\n\n---\n\n## Himalaya DSL 到 IMAP 的映射速查\n\n了解映射关系有助于理解服务器侧实际执行的搜索行为：\n\n| Himalaya DSL | IMAP SEARCH 键 | 备注 |\n|-------------|----------------|------|\n| `date D` | `SENTON D` | 精确匹配发送日期 |\n| `before D` | `SENTBEFORE D` | 不包含边界日 |\n| `after D` | `SENTSINCE (D+1)` | 为排除边界，Himalaya 会替你加一天 |\n| `from P` | `FROM P` | 模糊匹配发件人 |\n| `to P` | `TO P` | 模糊匹配收件人 |\n| `subject P` | `SUBJECT P` | 模糊匹配主题 |\n| `body P` | `BODY P` | 搜索正文，性能较低 |\n| `flag F` | 对应状态键 | 如 `flag seen` → `SEEN` |\n| `and` | 隐式 `AND`（多个 `SearchKey::And`） | 两者都必须满足 |\n| `or` | `OR` | 满足其一 |\n| `not` | `NOT` | 取反 |\n| `order by date desc` | `SortCriterion { reverse: true, key: Date }` | 需要服务器支持 `SORT` 扩展 |\n\n---\n\n## 性能与兼容性提示\n\n1. **优先使用头部字段搜索**：`from`、`to`、`subject` 比 `body` 搜索速度快得多\n2. **避免频繁全文搜索**：`body` 会触发服务器全文扫描，大量邮件时较慢\n3. **排序依赖服务器能力**：\n - 若服务器支持 `SORT` 扩展，Himalaya 使用 `UID SORT` 在服务器端排序并分页\n - 若不支持，Himalaya 先 `SEARCH` 获取 UID，然后在客户端内存中排序和分页\n4. **日期格式**：Himalaya 支持 `yyyy-mm-dd`、`yyyy/mm/dd`、`dd-mm-yyyy`、`dd/mm/yyyy` 四种日期格式\n5. **引号与特殊字符**：查询中包含空格或括号时，请使用双引号包裹或反斜杠转义\n\n---\n\n## 参考文件\n\n- Himalaya CLI 查询解析入口：`src/email/envelope/command/list.rs`\n- 底层查询 AST 与 IMAP 映射：`email-lib` 中的 `src/email/envelope/list/imap.rs`\n- 查询语法解析器：`email-lib` 中的 `src/email/search_query/parser.rs`\n\nFile v1.0.0:skill-card.md\n\n## Description:\n\nExpert guidance for querying, writing, and managing emails using the `himalaya` CLI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bird-frank](https://clawhub.ai/user/bird-frank)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and email users use this skill to construct and review Himalaya CLI commands for listing and searching email, composing messages, and managing flags, folders, templates, and attachments.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated guidance may include send, reply, forward, delete, purge, or expunge email actions.\n\nMitigation: Review account, folder, message IDs, recipients, and all send or destructive actions before allowing any generated command to run.\n\nRisk: Broad email search and management commands may target the wrong account, folder, message, or recipient if parameters are incorrect.\n\nMitigation: Validate generated Himalaya query strings, account flags, folder flags, message IDs, and recipients against the intended mailbox before execution.\n\n## Reference(s):\n\n- [Bundled Query DSL Reference](references/query_dsl.md)\n- [Himalaya Repository](https://github.com/pimalaya/himalaya)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown with inline bash code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Single-response guidance with commands for a user to review before execution.]\n\n## Skill Version(s):\n\n1.0.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.0:evals/evals.json\n\n{\n \"skill_name\": \"himalaya\",\n \"evals\": [\n {\n \"id\": 1,\n \"prompt\": \"I need to find all unread emails from my boss (boss@example.com) in Himalaya, sorted with the newest first. Give me the exact command to run.\",\n \"expected_output\": \"The assistant returns the correct himalaya CLI command using 'not flag seen', 'from boss@example.com', and 'order by date desc'.\",\n \"files\": [],\n \"expectations\": [\n \"The output contains the command 'himalaya envelope list'\",\n \"The output includes 'not flag seen' or equivalent unread filter\",\n \"The output includes 'from boss@example.com'\",\n \"The output includes 'order by date desc'\",\n \"The command is syntactically valid for the Himalaya query DSL\"\n ]\n },\n {\n \"id\": 2,\n \"prompt\": \"Show me how to compose and send an email to the team@example.com with the subject 'Weekly Sync' using himalaya. Include any relevant flags or options I should know about.\",\n \"expected_output\": \"The assistant explains how to use 'himalaya message write' with --to and --subject flags, and describes the $EDITOR workflow.\",\n \"files\": [],\n \"expectations\": [\n \"The output mentions 'himalaya message write'\",\n \"The output includes '--to team@example.com' or equivalent\",\n \"The output includes '--subject \\\"Weekly Sync\\\"' or equivalent\",\n \"The output mentions $EDITOR or interactive composition\",\n \"The output describes the template header format (From, To, Subject, blank line, body)\"\n ]\n },\n {\n \"id\": 3,\n \"prompt\": \"Using himalaya, how do I search for emails with the subject ' invoices ' (with a space) sent after 2025-03-01, and also show them in the Archive folder instead of INBOX? I want 15 per page and page 2.\",\n \"expected_output\": \"The assistant constructs a single himalaya envelope list command with proper quoting for the spaced subject, the after date filter, folder flag, pagination flags, and page size.\",\n \"files\": [],\n \"expectations\": [\n \"The output contains 'himalaya envelope list'\",\n \"The output includes a folder flag like '-f Archive' or '--folder Archive'\",\n \"The output includes '--page 2'\",\n \"The output includes '--page-size 15' or '-s 15'\",\n \"The output includes 'after 2025-03-01'\",\n \"The subject query correctly quotes or escapes the space in 'invoices'\"\n ]\n }\n ]\n}","readmeExcerpt":"Skill: Himalaya Owner: bird-frank Summary: Expert guidance for querying, writing, and managing emails using the himalaya CLI. Use this skill whenever the user wants to list emails, search envelopes,... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-19T04:46:49.995Z | user himalaya-skill 1.0.0 - Initial release providing expert guidance for the Himalaya command-line email client. - Covers email listing, searchin","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"himalaya [args...]"},{"language":"bash","snippet":"# List all envelopes in the default folder\nhimalaya envelope list\n\n# List envelopes in a specific folder, page 2, 20 per page\nhimalaya envelope list -f Archives.FOSS --page 2 --page-size 20\n\n# Thread view for envelopes matching a query\nhimalaya envelope thread subject \"product requirement\""},{"language":"text","snippet":"[filter-query] [order by sort-query]"},{"language":"bash","snippet":"# Unread emails, newest first\nhimalaya envelope list \"not flag seen order by date desc\"\n\n# From boss or CEO, sorted by date desc\nhimalaya envelope list \"from boss@example.com or from ceo@example.com order by date desc\"\n\n# Subject contains \"周报\" AND body contains \"进度\"\nhimalaya envelope list \"subject 周报 and body 进度\"\n\n# Date range: after March 31 and before April 11, 2025\nhimalaya envelope list \"after 2025-03-31 and before 2025-04-11\"\n\n# Complex grouped condition: (subject urgent OR body error) AND from ops\nhimalaya envelope list '(subject 紧急 or body 报错) and from ops@example.com'\n\n# Specific folder + pagination + query\nhimalaya envelope list -f INBOX --page 2 --page-size 20 'subject \"release plan\" order by date desc'"},{"language":"bash","snippet":"# Compose a new message interactively\nhimalaya message write\n\n# Pre-fill headers via CLI arguments\nhimalaya message write --to \"team@example.com\" --subject \"Sprint review\"\n\n# Compose using a saved template\nhimalaya message write --template /path/to/template.eml"},{"language":"bash","snippet":"# Reply to message ID 42\nhimalaya message reply 42\n\n# Reply-all\nhimalaya message reply 42 --all\n\n# Forward message ID 42\nhimalaya message forward 42 --to \"someone@example.com\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: himalaya\ndescription: |\n Expert guidance for querying, writing, and managing emails using the `himalaya` CLI.\n Use this skill whenever the user wants to list emails, search envelopes, compose messages,\n manage flags/folders, or execute any himalaya command. Also trigger when the user mentions\n \"email CLI\", \"terminal email\", \"manage emails from command line\", or references the\n Himalaya mail client. This skill provides the full query DSL specification, command\n patterns, and best practices for the himalaya email CLI.\n---\n\n# Himalaya CLI Expert\n\nThis skill makes you an instant expert on the [Himalaya](https://github.com/pimalaya/himalaya)\ncommand-line email client. Himalaya is a stateless CLI (not a TUI) that lets users manage emails\nvia shell commands.\n\n## When this skill applies\n\nUse this skill for ANY task involving:\n- Listing, searching, or sorting emails (`himalaya envelope list|thread`)\n- Reading, writing, replying to, or forwarding messages (`himalaya message ...`)\n- Managing flags (`himalaya flag ...`)\n- Managing folders/mailboxes (`himalaya folder ...`)\n- Message templates and attachments (`himalaya template ...`, `himalaya attachment ...`)\n- Interpreting or constructing Himalaya query DSL strings\n\n## Architecture overview\n\nHimalaya CLI is organized around nouns:\n\n```\nhimalaya [args...]\n```\n\nKey nouns:\n- `envelope` (aliases: `envelopes`) — email envelopes (metadata, no body)\n- `message` (aliases: `msg`, `msgs`, `messages`) — full email messages\n- `flag` (aliases: `flags`) — message flags (seen, answered, flagged, deleted…)\n- `folder` (aliases: `folders`, `mailbox`, `mailboxes`, `mbox`, `mboxes`) — mailboxes\n- `template` (aliases: `tpl`, `tpls`, `templates`) — message templates\n- `attachment` (aliases: `attachments`) — message attachments\n- `account` (aliases: `accounts`) — account configuration\n\nGlobal flags (available on all commands):\n- `--config ` — override config file path\n- `--output json` / `--output plain` — choose output format\n- `--quiet`, `--debug`, `--trace` — logging levels\n\nCommon per-command flags:\n- `-a ` / `--account ` — target a specific configured account\n- `-f ` / `--folder ` — target a specific folder\n\n## Querying emails: envelope commands\n\nThe most common operation is listing envelopes. Read the full Query DSL reference\n(`references/query_dsl.md`) **whenever the user asks anything about search, filter, sort,\nor list queries**.\n\n### Essential commands\n\n```bash\n# List all envelopes in the default folder\nhimalaya envelope list\n\n# List envelopes in a specific folder, page 2, 20 per page\nhimalaya envelope list -f Archives.FOSS --page 2 --page-size 20\n\n# Thread view for envelopes matching a query\nhimalaya envelope thread subject \"product requirement\"\n```\n\n### Query DSL quick reference\n\nA query string has the form:\n\n```\n[filter-query] [order by sort-query]\n```\n\n**Filter conditions:**\n- `date ` — exact date match\n- `before ` — strictly before "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn792wn2t4x4kdq3j345twmwv182x5m7\",\n \"slug\": \"himalaya-skill\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1776574009995\n}"},{"path":"references/query_dsl.md","content":"# Himalaya 邮件查询使用指南\n\n## 概述\n\nHimalaya 的 `envelope list` 和 `envelope thread` 命令支持一套专门设计的查询 DSL（领域特定语言），用于**筛选**和**排序**邮件。你的查询字符串会被 Himalaya 解析成 AST，最终转换为 IMAP `SEARCH` / `SORT` 命令发送给邮件服务器。\n\n> **注意**：Himalaya 的查询语法是高层封装，并非直接使用 IMAP 原始关键字，但底层会映射为 IMAP 搜索条件。\n\n---\n\n## 查询语法结构\n\n一条完整查询由 **过滤条件** 和 **排序条件** 组成，两者可选：\n\n```\n[filter-query] [order by sort-query]\n```\n\n- `filter-query`：指定筛选条件（可选）\n- `sort-query`：指定排序规则（可选）\n- 若两者同时存在，**过滤条件必须写在 `order by` 前面**\n\n---\n\n## 过滤条件语法\n\n### 基本形式\n\n过滤条件由**条件**和**运算符**组合而成，支持使用括号 `()` 改变优先级。\n\n### 可用的条件\n\n| Himalaya 语法 | 含义 | 对应 IMAP 搜索键 | 示例 |\n|--------------|------|-----------------|------|\n| `date ` | 日期精确匹配 | `SENTON` | `date 2025-04-12` |\n| `before ` | 日期严格小于 | `SENTBEFORE` | `before 2025-04-01` |\n| `after ` | 日期严格大于 | `SENTSINCE` (+1天) | `after 2025-04-01` |\n| `from ` | 发件人匹配 | `FROM` | `from alice@example.com` |\n| `to ` | 收件人匹配 | `TO` | `to bob@example.com` |\n| `subject ` | 主题匹配 | `SUBJECT` | `subject \"会议通知\"` |\n| `body ` | 正文内容匹配 | `BODY` | `body 项目进度` |\n| `flag ` | 邮件标志匹配 | 对应状态标志 | `flag seen` |\n\n### 可用的运算符\n\n| 运算符 | 优先级 | 含义 | 示例 |\n|--------|--------|------|------|\n| `not` | 最高 | 取反 | `not from spam@example.com` |\n| `and` | 中 | 两者都必须满足 | `from boss and subject 周报` |\n| `or` | 最低 | 满足其一即可 | `from alice or from bob` |\n\n**优先级规则**：`not` > `and` > `or`，复杂查询建议用括号明确优先级。\n\n### 模式匹配中的空格与引号\n\n- **引号**：用双引号包裹含空格的字符串，如 `subject \"foo bar\"`\n- **转义**：无引号模式下可用反斜杠转义空格和括号，如 `subject foo\\ bar`\n- 引号内可转义 `\\\"` 和 `\\\\`\n\n---\n\n## 排序条件语法\n\n使用关键字 `order by` 开头，后跟一个或多个排序字段，每个字段可指定 `asc` 或 `desc`。\n\n### 可用的排序字段\n\n| 字段 | 排序依据 |\n|------|---------|\n| `date` | 邮件日期 |\n| `from` | 发件人 |\n| `to` | 收件人 |\n| `subject` | 主题 |\n\n### 默认顺序\n\n- 不指定时默认为 **升序** (`asc`)\n- 多字段排序时按声明顺序依次应用\n\n---\n\n## 组合查询示例\n\n### 纯过滤\n```bash\n# 主题包含\"周报\"且正文包含\"进度\"\nhimalaya envelope list subject 周报 and body 进度\n\n# 来自老板或 CEO 的邮件\nhimalaya envelope list from boss@example.com or from ceo@example.com\n\n# 不是已删除的邮件（假设服务器支持相关标志）\nhimalaya envelope list not flag deleted\n```\n\n### 纯排序\n```bash\n# 按日期降序排列（最新的在前）\nhimalaya envelope list order by date desc\n\n# 先按发件人升序，再按主题降序\nhimalaya envelope list order by from asc subject desc\n```\n\n### 过滤 + 排序\n```bash\n# 查找未读邮件，按日期降序排列\nhimalaya envelope list not flag seen order by date desc\n\n# 查找4月以来的重要邮件，先按发件人排序再按日期排序\nhimalaya envelope list after 2025-04-01 and subject 重要 order by from date desc\n```\n\n---\n\n## 常见场景命令示例\n\n### 1. 查看未读邮件\n```bash\nhimalaya envelope list not flag seen\nhimalaya envelope list not flag seen order by date desc\n```\n\n### 2. 查看来自特定发件人的邮件\n```bash\nhimaya envelope list from alice@example.com\nhimalaya envelope list from alice@example.com order by date desc\n```\n\n### 3. 按日期范围查找\n```bash\n# 2025年4月1日至4月10日（before 不包含边界）\nhimalaya envelope list after 2025-03-31 and before 2025-04-11\n\n# 2025年4月12日当天的邮件\nhimalaya envelope list date 2025-04-12\n```\n\n### 4. 主题搜索\n```bash\n# 简单关键词\nhimalaya envelope list subject 项目\n\n# 带空格的短语\nhimalaya envelope list subject \"会议通知\"\n\n# 转义空格（等效写法）\nhimalaya envelope list subject 会议\\ 通知\n``"},{"path":"skill-card.md","content":"## Description:\n\nExpert guidance for querying, writing, and managing emails using the `himalaya` CLI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bird-frank](https://clawhub.ai/user/bird-frank)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and email users use this skill to construct and review Himalaya CLI commands for listing and searching email, composing messages, and managing flags, folders, templates, and attachments.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated guidance may include send, reply, forward, delete, purge, or expunge email actions.\n\nMitigation: Review account, folder, message IDs, recipients, and all send or destructive actions before allowing any generated command to run.\n\nRisk: Broad email search and management commands may target the wrong account, folder, message, or recipient if parameters are incorrect.\n\nMitigation: Validate generated Himalaya query strings, account flags, folder flags, message IDs, and recipients against the intended mailbox before execution.\n\n## Reference(s):\n\n- [Bundled Query DSL Reference](references/query_dsl.md)\n- [Himalaya Repository](https://github.com/pimalaya/himalaya)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown with inline bash code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Single-response guidance with commands for a user to review before execution.]\n\n## Skill Version(s):\n\n1.0.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"evals/evals.json","content":"{\n \"skill_name\": \"himalaya\",\n \"evals\": [\n {\n \"id\": 1,\n \"prompt\": \"I need to find all unread emails from my boss (boss@example.com) in Himalaya, sorted with the newest first. Give me the exact command to run.\",\n \"expected_output\": \"The assistant returns the correct himalaya CLI command using 'not flag seen', 'from boss@example.com', and 'order by date desc'.\",\n \"files\": [],\n \"expectations\": [\n \"The output contains the command 'himalaya envelope list'\",\n \"The output includes 'not flag seen' or equivalent unread filter\",\n \"The output includes 'from boss@example.com'\",\n \"The output includes 'order by date desc'\",\n \"The command is syntactically valid for the Himalaya query DSL\"\n ]\n },\n {\n \"id\": 2,\n \"prompt\": \"Show me how to compose and send an email to the team@example.com with the subject 'Weekly Sync' using himalaya. Include any relevant flags or options I should know about.\",\n \"expected_output\": \"The assistant explains how to use 'himalaya message write' with --to and --subject flags, and describes the $EDITOR workflow.\",\n \"files\": [],\n \"expectations\": [\n \"The output mentions 'himalaya message write'\",\n \"The output includes '--to team@example.com' or equivalent\",\n \"The output includes '--subject \\\"Weekly Sync\\\"' or equivalent\",\n \"The output mentions $EDITOR or interactive composition\",\n \"The output describes the template header format (From, To, Subject, blank line, body)\"\n ]\n },\n {\n \"id\": 3,\n \"prompt\": \"Using himalaya, how do I search for emails with the subject ' invoices ' (with a space) sent after 2025-03-01, and also show them in the Archive folder instead of INBOX? I want 15 per page and page 2.\",\n \"expected_output\": \"The assistant constructs a single himalaya envelope list command with proper quoting for the spaced subject, the after date filter, folder flag, pagination flags, and page size.\",\n \"files\": [],\n \"expectations\": [\n \"The output contains 'himalaya envelope list'\",\n \"The output includes a folder flag like '-f Archive' or '--folder Archive'\",\n \"The output includes '--page 2'\",\n \"The output includes '--page-size 15' or '-s 15'\",\n \"The output includes 'after 2025-03-01'\",\n \"The subject query correctly quotes or escapes the space in 'invoices'\"\n ]\n }\n ]\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1415,"uniquenessScore":41,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T17:38:15.574Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:59:21.530Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}