Agent Skills

Agent Skills for email

A skill is a markdown file that teaches an agent one job end to end: the calls, their order, and what to do when one is refused. These five cover the work an agent actually has to do with email, and they are the same files our own MCP server hands out.

Served at /.well-known/agent-skills/ · discovery spec 0.2.0 · free to copy

The five skills

How an agent finds them

The index is generated from the files themselves, and the digest is the sha256 of the exact bytes served. That is the part worth checking in someone else's implementation too: an index maintained by hand starts describing skills that no longer say what it claims, and nothing breaks when it does.

Discovery
curl https://sending.dev/.well-known/agent-skills/index.json

{
  "version": "0.2.0",
  "skills": [
    {
      "name": "connect-mcp",
      "description": "Connect to Sending's MCP server and get the right permissions...",
      "url": "/.well-known/agent-skills/connect-mcp/SKILL.md",
      "digest": "sha256:..."
    }
  ]
}

Each file is also readable as a page here, and every page answers in markdown on Accept: text/markdown or with a .md suffix.

What a skill will never do

Teach an agent to get around a guardrail. Sending refuses a send from an unverified domain, drops addresses on the suppression list, requires an idempotency key, applies per-key volume and spend caps, and writes every tool call to an audit log. All of it is enforced on our servers. A skill that promised otherwise would just be describing a product that does not exist.

The MCP server · MCP docs · Raw skill file

Questions

What is an agent skill?

A skill is a markdown file that teaches an AI agent how to do one job with a product: what to call, in which order, and what to do when it fails. It is not documentation for humans that an agent happens to read. It is written for the agent, and it is loaded into the model's context when the job comes up.

How does an agent find them?

They are published at /.well-known/agent-skills/index.json, following the skills discovery spec. The index lists each skill with its name, description, URL and a sha256 digest of the exact bytes served, so a client can cache one and know when it has changed.

Do I have to install anything?

No. The skills are plain files served over HTTP, and the tools they describe live on our MCP server at https://sending.dev/api/mcp. There is no package to install and no runtime of ours on your machine.

Can I copy one into my own agent?

Yes. Copy the markdown, keep it, edit it. They are written to be pasted into a system prompt or dropped into a skills folder. The digest in the index tells you when ours has moved on.

What does a skill assume about permissions?

That the agent has an API key or an OAuth grant with the right scopes, and that anything destructive stays gated server-side. A skill never tells an agent how to get around a verified-domain check, a suppression list or a spend cap, because it cannot: those are enforced on our servers, not in the prompt.

Start with Sending

Give your agent something worth sending.

3,000 messages a month, free. No card. The MCP endpoint is on every plan, including this one.