Agent Skills

An Agent Skill is a portable instruction file (SKILL.md) that teaches an AI agent how to do something correctly. Samva publishes a samva skill so that agents working in your codebase or terminal — not just ones connected to the hosted MCP server — know how to integrate Samva email the right way.

What the skill teaches

The samva skill is a router: it points an agent to the right surface for the job, then to a focused reference for each one.

• Choosing a surface — SDK/REST for application code, the CLI for terminal work, MCP for an agent taking actions.
• Authentication — API keys versus OAuth login, and how each scopes the organization.
• The email workflow — authenticate, resolve the organization, send, and check delivery status.

Discovery

Samva serves the skill for automatic discovery following the Cloudflare Agent Skills discovery format. A skills-capable client fetches the index and then the skill archive:

The index lists the samva skill with a sha256 digest of the archive. Clients verify the digest after download, so they only ever load the exact bytes Samva published.

{
  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "samva",
      "type": "archive",
      "description": "Integrate Samva for transactional email…",
      "url": "samva.tar.gz",
      "digest": "sha256:…"
    }
  ]
}

Agent Skills versus MCP

Both help an agent work with Samva, through different mechanisms:

A typical agent loads the skill to decide which surface to use and how to authenticate, then acts — by calling MCP tools, the SDK, or the CLI.

Next steps