yacli-find-and-read

yacli-find-and-read is a skill for Claude Code, Codex from NextStat/yacli. It costs 48 tokens per session (262 once invoked), scanned A, original, MIT.

A skill for finding an email by a keyword and then opening the matching message. It uses the yacli command-line mail tool and searches the inbox by default.

In plain words
What is it for?
Use it to find mail from a person, locate messages about a topic, or search another mail folder by supplying its name.
Why use it?
It provides a clear two-step way to locate a specific message without manually browsing the mailbox. The message's UID, its unique identifier, is used to open the selected result.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to find mail from a person, locate messages about a topic, or search another mail folder by supplying its name.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/nextstat/yacli/yacli-find-and-read
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add NextStat/yacli --skill yacli-find-and-read
Clone the repo
git clone --depth 1 https://github.com/NextStat/yacli

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for yacli-find-and-read

README.md
[![agentmods](https://agentmods.dev/badge/skills/nextstat/yacli/yacli-find-and-read/github.svg)](https://agentmods.dev/skills/nextstat/yacli/yacli-find-and-read)
Your own site
<a href="https://agentmods.dev/skills/nextstat/yacli/yacli-find-and-read"><img src="https://agentmods.dev/badge/skills/nextstat/yacli/yacli-find-and-read/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for yacli-find-and-read

Your own site · 80×15
<a href="https://agentmods.dev/skills/nextstat/yacli/yacli-find-and-read"><img src="https://agentmods.dev/badge/skills/nextstat/yacli/yacli-find-and-read.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 262 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.00262
Opus 5 $0.00024 $0.00131
Sonnet 5 $0.00010 $0.00052
Haiku 4.5 $0.00005 $0.00026

Measured 12d ago against content hash 3fa63c2431f2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

yacli-find-and-read scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/yacli-find-and-read/SKILL.md · 35 lines

What it actually says

Найти и прочитать письмо

Двухшаговый сценарий: поиск → чтение.

Шаги

  1. Найди письмо:
yacli mail search "ЗАПРОС" --limit 5
  1. Выбери нужное письмо из результатов. Запомни поле uid.

  2. Прочитай его:

yacli mail read UID

Заметки

  • Поиск по умолчанию идёт в INBOX. Для других папок: --folder ПАПКА.
  • Если результатов слишком много — уточни запрос или уменьши --limit.
  • uid из шага 1 — обязательный аргумент для шага 3.
  • Если пользователь ищет «письмо от Иванова» — используй фамилию как запрос.
  • Если пользователь ищет «письмо про отчёт» — используй ключевое слово из темы.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 35 lines · 48 tokens per session scan A 3fa63c2431f2

Subscribe to this mod's changes

yacli-find-and-read is a skill published in the GitHub repository NextStat/yacli (19 stars, last pushed 6mo ago), licensed MIT. It adds 48 tokens to every session and 262 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

c-email

Read, send, search, and label email via gog (Gmail CLI) or himalaya (IMAP). Supports inbox management, drafting replies, thread viewing, and label/folder operations across Gmail and standard IMAP accounts.

daxaur/openpaw · 49 tokens

thunderbird-cli

Manage email through Mozilla Thunderbird — read, search, compose, reply, forward, archive, move, tag, download attachments, and bulk-operate across all configured IMAP/SMTP accounts via the thunderbird-cli-mcp server. Use whenever the user mentions "email", "inbox", "mailbox", "unread", "messages", asks to "check…

vitalio-sh/thunderbird-cli · 169 tokens

vamoose

Book time off without the busywork. Prompts for your dates and subject, creates a calendar hold shown as free, invites your manager to approve it, then fans the event out to your team as optional attendees once approved. Backs onto Microsoft 365, Outlook, and Teams via Microsoft Graph, or Google Calendar. Trigger when…

dcadolph/vamoose · 92 tokens

email

Run the external email CLI through exec for real IMAP/SMTP/Notmuch mailboxes. Use when the user explicitly wants a real terminal email workflow instead of the built-in benchmark email surfaces.

IceWhaleTech/ZimaOS-Blue · 41 tokens

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).

JansenAnalytics/claudex · 55 tokens

obsidian-bases

Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.

kepano/obsidian-skills · 63 tokens