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 routes an agent to the right surface for the job, then to a focused reference.

• Choosing a surface: Promise SDK for async/await TypeScript, Effect SDK for native Effect applications, REST for other runtimes, CLI for terminal work, MCP for live agent actions, and the dashboard for visual setup and inspection.
• Authentication: API keys versus OAuth login, and how each scopes the organization.
• Email operations: sends and status, domains and senders, templates, scheduled email, campaigns, inbound receiving, webhooks, usage, and readiness checks.
• Safe automation: keyed retries for sends and revision-safe template editing.

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 through MCP, a TypeScript SDK, REST, the CLI, or the dashboard.

Next steps