Communitygithub.com

SamuelChien/mega-skills-collection

E-Mail-Infrastruktur für KI-Agenten. Erstelle Konten, sende/empfange E-Mails, verwalte Webhooks und prüfe das Karma-Guthaben über die AgentMail-API.

Was ist mega-skills-collection?

AgentMail bietet KI-Agenten echte E-Mail-Adressen (`@theagentmail.net`) mit einer einfachen REST-API. Agenten können damit E-Mails senden und empfangen, sich für Dienste wie GitHub, AWS oder Slack registrieren und Verifizierungscodes abrufen. Ein integriertes Karma-System verhindert Spam und sorgt für eine hohe Reputation der Shared Domain. Das Skill unterstützt die vollständige Verwaltung von E-Mail-Konten, Webhooks und die Überwachung des Karma-Guthabens. Es ist ideal für Agenten, die eigenständige Kommunikation oder Anmeldeflüsse durchführen müssen. Die Nutzung ist über direkte cURL-Befehle oder das TypeScript SDK möglich.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agentmail

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AgentMail — E-Mail für KI-Agenten

AgentMail gibt KI-Agenten echte E-Mail-Adressen (@theagentmail.net) mit einer REST-API. Agenten können E-Mails senden und empfangen, sich für Dienste (GitHub, AWS, Slack, usw.) registrieren und Verifizierungscodes erhalten. Ein Karma-System verhindert Spam und hält den Ruf der gemeinsamen Domain hoch.

Basis-URL: https://api.theagentmail.net

Wann verwenden

  • Ein KI-Agent benötigt ein echtes Postfach für Registrierungen, Verifizierungsabläufe oder transaktionale Kommunikation.
  • Sie müssen AgentMail-Konten bereitstellen, Nachrichten senden, Posteingänge lesen oder eingehende Webhooks registrieren.
  • Sie müssen die Karma-Nutzung überwachen oder E-Mail-Ereignisse in die Agentenautomatisierung einbinden.

Schnellstart

Alle Anfragen benötigen den Header Authorization: Bearer am_... (API-Schlüssel aus dem Dashboard).

E-Mail-Konto erstellen (-10 Karma)

curl -X POST https://api.theagentmail.net/v1/accounts \
  -H "Authorization: Bearer am_..." \
  -H "Content-Type: application/json" \
  -d '{"address": "[email protected]"}'

Antwort: {"data": {"id": "...", "address": "[email protected]", "displayName": null, "createdAt": 123}}

E-Mail senden (-1 Karma)

curl -X POST https://api.theagentmail.net/v1/accounts/{accountId}/messages \
  -H "Authorization: Bearer am_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Hallo von meinem Agenten",
    "text": "Nur-Text-Nachricht",
    "html": "<p>Optionaler HTML-Inhalt</p>"
  }'

Optionale Felder: cc, bcc (String-Arrays), inReplyTo, references (Strings für Threading), attachments (Array von {filename, contentType, content}, wobei content base64-codiert ist).

Posteingang lesen

# Nachrichten auflisten
curl https://api.theagentmail.net/v1/accounts/{accountId}/messages \
  -H "Authorization: Bearer am_..."

# Vollständige Nachricht abrufen (mit Inhalt und Anhängen)
curl https://api.theagentmail.net/v1/accounts/{accountId}/messages/{messageId} \
  -H "Authorization: Bearer am_..."

Karma prüfen

curl https://api.theagentmail.net/v1/karma \
  -H "Authorization: Bearer am_..."

Antwort: {"data": {"balance": 90, "events": [...]}}

Webhook registrieren (Echtzeit-Eingang)

curl -X POST https://api.theagentmail.net/v1/accounts/{accountId}/webhooks \
  -H "Authorization: Bearer am_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://my-agent.example.com/inbox"}'

Webhook-Zustellungen enthalten zwei Sicherheits-Header:

  • X-AgentMail-Signature – HMAC-SHA256-Hex-Digest des Anfragekörpers, signiert mit dem Webhook-Geheimnis
  • X-AgentMail-Timestamp – Millisekunden-Zeitstempel der Zustellung

Überprüfen Sie die Signatur und lehnen Sie Anfragen mit Zeitstempeln älter als 5 Minuten ab, um Replay-Angriffe zu verhindern:

import { createHmac } from "crypto";

const verifyWebhook = (body: string, signature: string, timestamp: string, secret: string) => {
  if (Date.now() - Number(timestamp) > 5 * 60 * 1000) return false;
  return createHmac("sha256", secret).update(body).digest("hex") === signature;
};

Anhang herunterladen

curl https://api.theagentmail.net/v1/accounts/{accountId}/messages/{messageId}/attachments/{attachmentId} \
  -H "Authorization: Bearer am_..."

Antwort: {"data": {"url": "https://signed-download-url..."}}

Vollständige API-Referenz

MethodePfadBeschreibungKarma
POST/v1/accountsE-Mail-Konto erstellen-10
GET/v1/accountsAlle Konten auflisten
GET/v1/accounts/:idKontodetails abrufen
DELETE/v1/accounts/:idKonto löschen+10
POST/v1/accounts/:id/messagesE-Mail senden-1
GET/v1/accounts/:id/messagesNachrichten auflisten
GET/v1/accounts/:id/messages/:msgIdVollständige Nachricht abrufen
GET/v1/accounts/:id/messages/:msgId/attachments/:attIdAnhang-URL abrufen
POST/v1/accounts/:id/webhooksWebhook registrieren
GET/v1/accounts/:id/webhooksWebhooks auflisten
DELETE/v1/accounts/:id/webhooks/:whIdWebhook löschen
GET/v1/karmaGuthaben + Ereignisse abrufen

Karma-System

Jede Aktion hat einen Karma-Preis oder eine Belohnung:

EreignisKarmaWarum
money_paid+100Guthaben kaufen
email_received+2Jemand von einer vertrauenswürdigen Domain hat geantwortet
account_deleted+10Karma-Erstattung beim Löschen einer Adresse
email_sent-1Senden kostet Karma
account_created-10Erstellen von Adressen kostet Karma

Wichtige Regeln:

  • Karma wird nur für eingehende E-Mails von vertrauenswürdigen Anbietern vergeben (Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, Hey, usw.). E-Mails von unbekannten/Wegwerf-Domains bringen kein Karma.
  • Sie erhalten Karma nur einmal pro Absender, bis der Agent antwortet. Wenn Absender X Ihnen 5 Mal ohne Antwort schreibt, wird nur die erste E-Mail belohnt. Antworten Sie X, dann bringt die nächste E-Mail von X wieder Karma.
  • Das Löschen eines Kontos erstattet die 10 Karma, die die Erstellung gekostet hat.

Wenn das Karma 0 erreicht, geben Senden und Kontoerstellung HTTP 402 zurück. Überprüfen Sie immer den Kontostand, bevor Sie Aktionen ausführen, die Karma kosten.

TypeScript SDK

import { createClient } from "@agentmail/sdk";

const mail = createClient({ apiKey: "am_..." });

// Konto erstellen
const account = await mail.accounts.create({
  address: "[email protected]",
});

// E-Mail senden
await mail.messages.send(account.id, {
  to: ["[email protected]"],
  subject: "Hallo",
  text: "Gesendet von einem KI-Agenten.",
});

// Posteingang lesen
const messages = await mail.messages.list(account.id);
const detail = await mail.messages.get(account.id, messages[0].id);

// Anhänge
const att = await mail.attachments.getUrl(accountId, messageId, attachmentId);
// att.url ist eine signierte Download-URL

// Webhooks
await mail.webhooks.create(account.id, {
  url: "https://my-agent.example.com/inbox",
});

// Karma
const karma = await mail.karma.getBalance();
console.log(karma.balance);

Fehlerbehandlung

import { AgentMailError } from "@agentmail/sdk";

try {
  await mail.messages.send(accountId, { to: ["[email protected]"], subject: "Hi", text: "Hey" });
} catch (e) {
  if (e instanceof AgentMailError) {
    console.log(e.status);   // 402, 404, 401, usw.
    console.log(e.code);     // "INSUFFICIENT_KARMA", "NOT_FOUND", usw.
    console.log(e.message);
  }
}

Häufige Muster

Für einen Dienst registrieren und die Verifizierungs-E-Mail lesen

const account = await mail.accounts.create({
  address: "[email protected]",
});

// Mit der Adresse registrieren (Browser-Automation, API, usw.)

// Auf Verifizierungs-E-Mail warten
for (let i = 0; i < 30; i++) {
  const messages = await mail.messages.list(account.id);
  const verification = messages.find(m =>
    m.subject.toLowerCase().includes("verify") ||
    m.subject.toLowerCase().includes("confirm")
  );
  if (verification) {
    const detail = await mail.messages.get(account.id, verification.id);
    // Verifizierungslink/-code aus detail.bodyText oder detail.bodyHtml parsen
    break;
  }
  await new Promise(r => setTimeout(r, 2000));
}

E-Mail senden und auf Antwort warten

const sent = await mail.messages.send(account.id, {
  to: ["[email protected]"],
  subject: "Frage zu Bestellung #12345",
  text: "Können Sie den Status prüfen?",
});

for (let i = 0; i < 60; i++) {
  const messages = await mail.messages.list(account.id);
  const reply = messages.find(m =>
    m.direction === "inbound" && m.timestamp > sent.timestamp
  );
  if (reply) {
    const detail = await mail.messages.get(account.id, reply.id);
    // Antwort verarbeiten
    break;
  }
  await new Promise(r => setTimeout(r, 5000));
}

Typen

type Account = { id: string; address: string; displayName: string | null; createdAt: number };
type Message = { id: string; from: string; to: string[]; subject: string; direction: "inbound" | "outbound"; status: string; timestamp: number };
type MessageDetail = Message & { cc: string[] | null; bcc: string[] | null; bodyText: string | null; bodyHtml: string | null; inReplyTo: string | null; references: string | null; attachments: AttachmentMeta[] };
type AttachmentMeta = { id: string; filename: string; contentType: string; size: number };
type KarmaBalance = { balance: number; events: KarmaEvent[] };
type KarmaEvent = { id: string; type: string; amount: number; timestamp: number; metadata?: Record<string, unknown> };

Einschränkungen

  • Verwenden Sie dieses Skill nur, wenn die Aufgabe eindeutig mit dem oben beschriebenen Umfang übereinstimmt.
  • Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
  • Fragen Sie nach, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Verwandte Skills