agentleFS
nikarmontag-cmdnikarmontag-cmd/claude-yandex-mail/skills/compose-email/SKILL.md

compose-email

Skill1 starsChanged 7 months agoMITView on GitHub

Draft and send a new business email through the user's Yandex Mail account, applying the user's configured HTML signature (with optional logo) and waiting for explicit confirmation before sending. Use when the user says "write an email to X", "send X a message", "compose an email about Y", "напиши письмо", "отправь письмо", "составь письмо".

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. nitrosend/claude★ 3same name
    2. nabcht/Zephyr★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 4 are distinctive, and 7 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 7

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use this skill when the user wants to send a NEW email.

    line 8
  2. Very specific:

    Run echo $CLAUDE_PLUGIN_ROOT to get the plugin root, then:

    line 23
  3. Very specific:

    Read $CLAUDE_PLUGIN_ROOT/assets/signature.html (HTML version of signature) — if the file does not exist, the user has not run setup yet.

    line 25
  4. Very specific:

    Read $CLAUDE_PLUGIN_ROOT/assets/signature.txt (plain version) — same fallback rule.

    line 26
  5. Very specific:

    Check whether $CLAUDE_PLUGIN_ROOT/assets/logo.jpg or assets/logo.png exists.

    line 27
  6. Distinctive:

    Avoid: filler small talk, unnecessary exclamation marks, emoji, vague pleasantries.

    line 36
  7. Distinctive:

    Do not send without explicit confirmation, even if the user's request looks like an unambiguous command.

    line 88
  8. Very specific:

    Do not pass inline_images if the logo file doesn't exist on disk — the email will fail to build.

    line 89
  9. Distinctive:

    Do not invent a recipient email address from memory or guess at a domain — ask.

    line 90
  10. Distinctive:

    Do not skip the plain-text body — old clients and spam filters need it.

    line 91
  11. Very specific:

    Do not edit assets/signature.html from this skill — that's the setup script's responsibility.

    line 92

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Compose Email — new business email from configured Yandex account

Use this skill when the user wants to send a NEW email. If they want to reply to an existing incoming message, use the reply-to-email skill instead.

Steps

1. Gather parameters

From the user's request extract:

  • Recipient — name and/or email. If only a name is given and you don't have an email for them, ask. Don't guess.
  • Goal — what the email should accomplish (send a quote, schedule a meeting, ask a question, deliver documents, etc.)
  • Key points — what must be in the body
  • Subject — if not given, propose one and ask for confirmation
  • Attachments — if files are mentioned, ask for absolute paths

2. Load the user's signature

Run echo $CLAUDE_PLUGIN_ROOT to get the plugin root, then:

  • Read $CLAUDE_PLUGIN_ROOT/assets/signature.html (HTML version of signature) — if the file does not exist, the user has not run setup yet; tell them to run ./scripts/setup.sh and stop.
  • Read $CLAUDE_PLUGIN_ROOT/assets/signature.txt (plain version) — same fallback rule.
  • Check whether $CLAUDE_PLUGIN_ROOT/assets/logo.jpg or assets/logo.png exists. If yes, the HTML signature already references cid:plugin-logo and you must pass the logo via inline_images. If neither exists, the HTML signature has no logo cell and you must NOT pass inline_images.

3. Draft the body

Match the user's stated language preference. If unclear, default to the language of the recipient's name. Use a business-formal tone:

  • Open with a proper salutation (use the recipient's name; in Russian use full first name + patronymic when known)
  • 2–4 short paragraphs: context first, then the point, then a clear call to action or question
  • Close with "С уважением," / "Best regards," on its own line — the signature follows

Avoid: filler small talk, unnecessary exclamation marks, emoji, vague pleasantries.

4. ALWAYS show the draft and wait for confirmation

Show the user:

  • To
  • Subject
  • Full body (without the signature — it will be appended automatically)
  • Attachment list

Ask: "Отправить? / Send this?"

Send only after an explicit yes (да, отправляй, send, go). On any other response, edit and re-show.

5. Send

Build the final email by combining the body and signature.

HTML version — the body in <p>...</p> paragraphs, then the loaded signature.html content:

<!DOCTYPE html>
<html><body style="font-family: -apple-system, 'Segoe UI', Arial, sans-serif; color: #1a1a1a; font-size: 14px; line-height: 1.5;">
<p>...body paragraph 1...</p>
<p>...body paragraph 2...</p>
<p style="margin-top: 24px;">С уважением,</p>
{{INSERT signature.html CONTENT HERE}}
</body></html>

Plain version — the body, a blank line, then "С уважением," / "Best regards,", then signature.txt content.

Tool call:

mcp__yandex-mail__send_email(
  to_email="<email>",
  subject="<subject>",
  body="<plain body + signature.txt>",
  html_body="<full HTML above>",
  inline_images=[{"path": "<absolute path to assets/logo.jpg or .png>", "cid": "plugin-logo"}]  # ONLY if logo file exists
                # otherwise omit this parameter entirely
  attachments=["<paths>"]  # only if user provided files
)

6. Confirm completion

Reply briefly: "Отправлено на <email> (тема: <subject>)" / "Sent to <email> (subject: <subject>)". List attachments if any.

What not to do

  • Do not send without explicit confirmation, even if the user's request looks like an unambiguous command.
  • Do not pass inline_images if the logo file doesn't exist on disk — the email will fail to build.
  • Do not invent a recipient email address from memory or guess at a domain — ask.
  • Do not skip the plain-text body — old clients and spam filters need it.
  • Do not edit assets/signature.html from this skill — that's the setup script's responsibility. If the user wants a different signature, tell them to re-run ./scripts/setup.sh (after deleting the old signature.html and signature.txt).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.