Mailneo
|Docs

Resources

Agent Skills

Run your email marketing from an AI coding agent. Agent skills are folders of instructions in the open SKILL.md format that agents load on demand — one standard understood by Claude Code, OpenAI Codex CLI, Cursor, Gemini CLI and GitHub Copilot, so a single repository serves them all. Mailneo/skills (MIT) ships five: an operator skill for the Mailneo API plus four platform-agnostic email-marketing knowledge skills that are useful even if you never touch the API.

The five skills

SkillWhat it knows
mailneoOperating the Mailneo API end to end: subscribers, lists, segments, contacts, campaigns, newsletters, templates, suppressions, analytics, webhooks — and the send discipline (a send is always previewed, shown to you, and confirmed by you).
email-copywritingSubject lines, preview text, body structure, CTAs, personalization, follow-ups — for cold outreach and newsletters.
email-deliverabilitySPF/DKIM/DMARC, warmup, volume, the Google/Yahoo/Microsoft bulk-sender rules, complaint math, troubleshooting inbox placement.
email-lifecycleList growth, hygiene and sunset policies, segmentation, welcome/nurture/win-back journeys, cadence, A/B testing that is honest about sample size.
email-complianceCAN-SPAM, GDPR, CASL, PECR — consent, unsubscribe rules, cold-email lawfulness by jurisdiction, and the tactics you must not use. Practical guidance, not legal advice.

Install

The Any agent path auto-detects which agents you have installed. For project-local installs with Claude Code, copy into .claude/skills/ inside the project instead of the home directory.

npx skills add Mailneo/skills

Connect your Mailneo account

  1. In Mailneo: Settings → API Keys → Create key. Grant the scopes you want the agent to have — reads only is a fine way to start; add *:write scopes when you're ready, and the *:send scopes only if you want the agent to be able to propose sends.
  2. Export it where your agent runs:
export MAILNEO_API_KEY=mk_live_...

That is the whole setup. The mailneo skill checks the key and adapts to the scopes it finds — a read-only key simply narrows what the agent offers to do.

The send rule

Sending through the Mailneo API is a two-step protocol: a preview returns exactly who would receive the email, what it costs, and a single-use confirmation token; only a separate confirm call sends. The mailneo skill hard-codes the discipline on top: the agent must show you the preview impact and get your explicit yes before confirming — and if the audience changed in between, the API itself forces a fresh preview.

An agent cannot silently email your list: the API demands a preview, and the skill demands that the preview reaches you. The protocol itself is documented in the sending concepts page.

Try these first

  • "Audit my email deliverability setup and tell me what the 2024+ bulk-sender rules require that I'm missing."
  • "Which of my segments has the highest open rate? Show the numbers."
  • "Import these 200 contacts, put them on a new list called Beta Users, and set up a welcome email — draft only."