GroundmailDocs

Agent Skills

Official Agent Skills for Cursor, Claude Code, Codex, and other clients that support the Agent Skills format.

Skills teach agents how to send with Groundmail, install MCP/CLI, and follow email deliverability basics — without stuffing the entire docs corpus into every prompt.

Index: llms.txt · Agent skill notes · MCP server · GitHub (public)

Install

# All four skills
npx skills add Groundmail/groundmail-skills -y

# Individual skills
npx skills add Groundmail/groundmail-skills --skill groundmail -y
npx skills add Groundmail/groundmail-skills --skill groundmail-mcp -y
npx skills add Groundmail/groundmail-skills --skill groundmail-cli -y
npx skills add Groundmail/groundmail-skills --skill email-best-practices -y

Scope flags:

  • -g — install globally for your user
  • default — project-level skills in the current repo

Machine-readable listing: /.well-known/agent-skills/index.json

Available skills

Skill When to use
groundmail Send API, gm_ auth, sandbox rules, domains, SDK / OpenAPI
groundmail-mcp Install and use groundmail-mcp in Cursor or Claude Code
groundmail-cli Terminal flows (emails, domains, webhooks, suppressions, …)
email-best-practices SPF/DKIM, suppressions, key hygiene, sandbox vs production

For React Email authoring and preview, use React Email’s own tools and skills. Send with Groundmail — see Send React Email (npm install groundmail @react-email/render react).

Cursor / Claude / Codex

After npx skills add …, restart or reload the agent so skill names/descriptions are discovered. The agent loads full SKILL.md bodies only when a task matches the skill description.

Prefer:

  1. Install groundmail for any send/integration work
  2. Add groundmail-mcp when the user wants MCP tools instead of writing HTTP
  3. Add email-best-practices when reviewing deliverability or production readiness

The dashboard Get started page can still generate a personalized setup prompt (API key + sandbox rules) for Cursor or Claude.