recoup-platform-email-helper — Claude Code skill

What recoup-platform-email-helper does

Reach for this skill when a task calls for mailing a report, summary or notification to the account owner or another recipient. It ships one Node script, scripts/send-email.mjs, which handles body serialization on its own. Building the JSON by hand with curl and inline jq is the fragile path: bad quoting lets a footer-only message titled “Message from Recoup” go out while the API still answers success:true. The script drops shell serialization entirely.

Writing the body to a file is the safer route, especially for HTML, since escaping stops being a concern. The script takes --subject, --html-file or --html, --text-file or --text, --to, --cc and --chat-id. With --dry-run it validates the payload and prints it without sending, which works as a preview. Leave --to out and the message goes to the account's own address.

A body is mandatory and there must be exactly one: with no non-empty --html or --text the script exits with code 2 and sends nothing. A non-zero code means the mail did not leave — read stderr and fix it rather than reporting success. Credentials come from the environment as RECOUP_API_KEY or RECOUP_ACCESS_TOKEN plus RECOUP_API_BASE; never print them. Node only, no dependencies, and python3 is not guaranteed in the sandbox.