Agent skill

E2a Doctor

by tokencanopy in tokencanopy/e2a

A skill your agent uses when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear.

Apache-2.0Auto-check passedBackend & APIs

Install E2a Doctor

skills CLI
$ npx skills add tokencanopy/e2a --skill e2a-doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tokencanopy/e2a e2a-doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tokencanopy/e2a.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/e2a/skills/e2a-doctor .claude/skills/e2a-doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
e2a-doctor
GitHub stars
192
Token cost
~994 tokens
SKILL.md length
488 words
Files
3 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear.

  • An existing e2a MCP connection
  • SKILL.md covers Start from the symptom, Read-only MCP diagnosis, Rank findings and Offer guided repairs, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Protection policy

What it does

E2a Doctor is an agent skill from tokencanopy/e2a. Use when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear. Diagnoses read-only through MCP first, ranks evidence-backed causes, and offers individually confirmed repairs; uses the CLI doctor only when CLI or self-hosted diagnostics are specifically relevant.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/diagnostic-matrix.md` and `references/guided-repairs.md`).

It sits in Backend & APIs, covering Email management, Webhooks and Transactional email. It works with Model Context Protocol. The repository describes itself as: Open-source email API for applications and AI agents. Managed hosting at e2a.dev, or self-host with Docker. The licence is Apache-2.0.

When your agent uses it

  • An existing e2a MCP connection
  • Protection policy
  • Message delivery is failing

Example prompts

  • “/e2a-doctor”

What it can do on your machine

Read from SKILL.md and the folder at commit 776fe2c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

E2a Doctor loads about 994 tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 488 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~994
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tokencanopy/e2a at commit 776fe2c, republished under its Apache-2.0 licence (© tokencanopy). 488 words, ~994 tokens.

Download SKILL.mdSave it as .claude/skills/e2a-doctor/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
e2a-doctor
description
Use when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear. Diagnoses read-only through MCP first, ranks evidence-backed causes, and offers individually confirmed repairs; uses the CLI doctor only when CLI or self-hosted diagnostics are specifically relevant.

Diagnose and repair e2a

Start from the symptom

Identify the failing surface and the smallest safe target: an inbox address, domain, webhook ID, message ID, time window, or exact error. Do not request message content unless it is necessary to diagnose the symptom. Inspect the available e2a MCP tools; use the e2a MCP whoami tool, never the shell command.

Keep diagnosis separate from repair. Begin MCP-first, read-only diagnosis with the existing authorization; do not create a second credential or alter configuration.

Read-only MCP diagnosis

Call whoami first, then load only the symptom's minimum reads from the diagnostic matrix. Use get_agent or list_agents only to establish inbox access; read get_protection and list_pending_messages for holds; use list_suppressions and list_agent_suppressions for recipient blocks; inspect get_domain and public, read-only DNS for domain symptoms; inspect get_webhook and list_webhook_deliveries for a webhook; and call get_message_lifecycle for one message's observed transitions.

Do not convert a missing tool, account-only scope, 401/403, or unavailable permission into a pass. Record it as an explicit skipped check, naming the unavailable read and the scope or authorization needed. Do not call verify_domain, test_webhook, redeliver_event, or any mutation while diagnosing.

Rank findings

Return a ranked list. Every finding must include {cause, evidence, impact, remediation} and state whether it is a definite configuration failure, authorization failure, asynchronous pending state, or transient service failure. Rank definite, high-impact causes above possibilities; keep evidence factual and targeted.

Treat accepted, scheduled, and pending_review as durable outcomes, not delivery receipts. Do not retry them: a second send can duplicate mail. Report the lifecycle or hold state, then wait for its next transition or an authorized human decision.

Show full SKILL.md (220 more words)Show less

Offer guided repairs

Offer the least invasive remedy only after presenting the finding and its expected effect. Read guided repairs before choosing one. Obtain confirmation for each state-changing repair; never bundle unrelated changes. A complete DNS diff confirmed as one unit is one repair. If confirmation is declined, leave state unchanged and report the manual next step.

After an accepted repair, perform the narrowest relevant read-only verification and update the finding; do not re-run a broad diagnostic sweep by default.

CLI-assisted branch

Use e2a doctor --json only when an already-authenticated CLI is the symptom's relevant surface, MCP is unavailable while that CLI already exists, or self-hosted diagnosis needs local environment or SMTP visibility. Interpret its versioned e2a.doctor/v1 checks as evidence, then supplement with relevant MCP reads when available. Never install or configure the CLI solely for diagnosis.

Classify the CLI report's auth/configuration/transient outcomes separately from MCP authorization and asynchronous message or DNS states. Preserve credentials and known configuration when evidence is inconclusive.

Verify and report

Report the ranked findings, explicit skipped checks, accepted repairs, and the narrowest verification result. Distinguish a configuration fix from a permission request, pending async work, or an operational retry. State what remains pending and the exact safe condition for a later recheck; do not claim domain readiness from registration or message delivery from acceptance alone.

© tokencanopy, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/e2a/skills/e2a-doctor of tokencanopy/e2a.

  • SKILL.md
  • references/diagnostic-matrix.md
  • references/guided-repairs.md

Open the folder on GitHubat commit 776fe2c

Compare with similar skills

E2a Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

E2a Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
E2a Doctor this skilltokencanopy/e2a192—~994Automated safety check: PassApache-2.0
X Twitter ScraperXquik-dev/x-twitter-scraper2091 repos~2.6kAutomated safety check: PassMIT
Zalo AgentPhucMPham/zalo-agent-cli163—~2.3kAutomated safety check: PassMIT
Yolfi Paymentsyolfinance/yolfi-agent178—~1.2kAutomated safety check: PassMIT
Frontmcp Channelsagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0
QA CLI MCP APIfastrepl/anarlog9.5k—~3.3kAutomated safety check: PassMIT

Similar skills

  • X Twitter Scraper

    Xquik-dev/x-twitter-scraper

    Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…

    209 GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check passed
  • Zalo Agent

    PhucMPham/zalo-agent-cli

    Automate Zalo messaging, Official Account (OA), and MCP server integration via zalo-agent-cli.

    163 GitHub stars~2.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Yolfi Payments

    yolfinance/yolfi-agent

    Add Yolfi crypto checkout, payment links, and webhook handling to an app through @yolfi/agent or the Yolfi MCP server.

    178 GitHub stars~1.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Frontmcp Channels

    agentfront/frontmcp

    A skill your agent uses when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges.

    146 GitHub stars~3.7k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • QA CLI MCP API

    fastrepl/anarlog

    Select and run explicitly requested, risk-based QA for Anarlog's CLI, webhooks, stdio MCP, hosted Cloud API, and remote MCP.

    9.5k GitHub stars~3.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • GitLab MCP Skill

    zereight/gitlab-mcp

    A skill your agent uses when working with the GitLab MCP server tools for merge requests, issues, repositories, pipelines, work items, variables, dependency proxy, vulnerabilities, webhooks, search…

    2k GitHub stars~2k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

More from tokencanopy/e2a

All 8 skills in this repo
  • Autopilot

    tokencanopy/e2a

    Conversationally configure and operate a policy-first, always-on local e2a email agent.

    192 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed
  • E2a

    tokencanopy/e2a

    A skill your agent uses when operating an already-connected e2a inbox over MCP: reading, composing, sending, replying, forwarding, handling attachments, managing contacts/outreach, scheduling mail…

    192 GitHub stars~4.7k tokensUpdated 3 days ago
    Auto-check passed
  • Email Evals

    tokencanopy/e2a

    Author and safely run deterministic email-agent evaluation suites with dedicated e2a test agents.

    192 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Tether

    tokencanopy/e2a

    Beta — Stay in the loop over email during a long-running coding session.

    192 GitHub stars~4.7k tokensUpdated 3 days ago
    Auto-check passed
  • Agentify

    tokencanopy/e2a

    Beta — Deploy the autonomous-repo feedback loop into a GitHub repo.

    192 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • E2a Integrate

    tokencanopy/e2a

    A skill your agent uses when adding e2a email capabilities to an application or codebase: outbound sending, inbound signed webhooks, REST polling, or SDK integration.

    192 GitHub stars~840 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about E2a Doctor

What does E2a Doctor do?

A skill your agent uses when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear. E2a Doctor is an agent skill from tokencanopy/e2a. Use when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear.

When should I use E2a Doctor?

E2a Doctor fits situations like: an existing e2a MCP connection; protection policy; message delivery is failing.

How do I install E2a Doctor in Claude Code?

Run `npx skills add tokencanopy/e2a --skill e2a-doctor -a claude-code`. Or copy the skill folder (plugins/e2a/skills/e2a-doctor in tokencanopy/e2a) into .claude/skills/e2a-doctor in your project. Claude Code loads it when a task matches its description.

How do I install E2a Doctor in Codex?

Run `npx skills add tokencanopy/e2a --skill e2a-doctor -a codex`. Or copy the skill folder (plugins/e2a/skills/e2a-doctor in tokencanopy/e2a) into .agents/skills/e2a-doctor in your project. Codex loads it when a task matches its description.

Can I use E2a Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tokencanopy/e2a --skill e2a-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/e2a-doctor, .gemini/skills/e2a-doctor, .github/skills/e2a-doctor and .opencode/skills/e2a-doctor in your project.

What does E2a Doctor need to run?

SKILL.md names no scripts, command-line tools or credentials: E2a Doctor is instructions for the agent only.

Does E2a Doctor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is E2a Doctor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does E2a Doctor use?

E2a Doctor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does E2a Doctor use?

About 994 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to E2a Doctor?

Skills that share tags, products or a category with E2a Doctor: X Twitter Scraper (Xquik-dev/x-twitter-scraper, 209 stars), Zalo Agent (PhucMPham/zalo-agent-cli, 163 stars), Yolfi Payments (yolfinance/yolfi-agent, 178 stars) and Frontmcp Channels (agentfront/frontmcp, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains E2a Doctor?

tokencanopy (a GitHub organization) maintains it in tokencanopy/e2a, which has 192 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 6, 2026.

Source: tokencanopy/e2a on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.