mail-use SKILL.md skillA

mail-use from leeguooooo/mail-use is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add leeguooooo/mail-use/mail-use@git:20261013.d628660

Pins git:20261013.d628660 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
leeguooooo/mail-use
Path
packaging/openai/SKILL.md
Versions recorded
2
Latest version
git:20261013.d628660, committed Oct 13, 2026
First version recorded
Oct 2, 2026
Size
6,792 bytes
Repository stars
48
License
MIT

Read, search, send and organize email across Gmail, Outlook, QQ, 163 and any IMAP/SMTP account through the mail-use command-line tool on the user's computer. Use when the user asks to check unread mail, find an email (an order confirmation, a customer reply, an invoice), read a thread, reply to or send an email, or move, mark, archive or clean up messages across one or more of their mailboxes. 查邮件、查未读、回复邮件、整理邮箱.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# mail-use

Drives the `mail-use` CLI, which talks directly to the user's own mail servers over IMAP/SMTP. Accounts and credentials live in a config file on the user's computer; nothing passes through a third-party service. Every command returns JSON with `success: boolean`, and on failure `error` plus a machine-readable `error_code`.

## Before the first call

1. Run `mail-use --version`. If the command is not found, stop and tell the user mail-use needs to be installed on their computer first. Point them to https://github.com/leeguooooo/mail-use#install and let them install it; do not download or run an installer yourself.
2. Run `mail-use account list --json`. If it returns no accounts, ask the user to add one: they copy `examples/accounts.example.json` from the repo to `~/.config/mailbox/auth.json` and fill in their own server and app password. Never ask the user to paste a password into the conversation, and never print the contents of `auth.json`.
3. Commands below need mail-use 2.11 or newer. On an older version, ask the user to update it (`mail-use upgrade`).

## Read and search

Always pass `--json` and check `success`.

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add leeguooooo/mail-use/mail-use@sha256:8879a1a595808875

The line at the top of this page pins the label git:20261013.d628660, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hbbqtnvoc7ncuhgn.svg)](https://markdownregistry.com/a/art_hbbqtnvoc7ncuhgn)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Oct 2, 2026 and Oct 13, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261013.d628660 latest2026-10-13 d628660 6,792 BA view · diff
git:20261002.399169c2026-10-02 399169c 6,230 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6792 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

leeguooooo/mail-use · 48 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hbbqtnvoc7ncuhgn
GET https://markdownregistry.com/api/v1/resolve?ref=leeguooooo/mail-use/mail-use
GET https://markdownregistry.com/api/v1/blob/8879a1a595808875a6129cc4fe738b51d4af77433edc7b12c1fa959072cda6c4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from leeguooooo/mail-use

AGENTS.md AGENTS.md file
leeguooooo/mail-use · AGENTS.md
git:20261001.37ed83e · audit A · 48 stars
mail-use SKILL.md skill
leeguooooo/mail-use · skills/mail-use/SKILL.md · Read, search, send, and manage email across Gmail, QQ, 163, Outlook and any IMAP/SMTP account from the command line…
v0.2.2 · audit B · 48 stars

Every file in leeguooooo/mail-use

Other files named mail-use

mail-use SKILL.md skill
leeguooooo/mail-use · skills/mail-use/SKILL.md · Read, search, send, and manage email across Gmail, QQ, 163, Outlook and any IMAP/SMTP account from the command line…
v0.2.2 · audit B · 48 stars

Browse by kind, by grade A, or by owner.