listener-creator

Build and deploy TypeScript email listeners that react to real-time email events.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/edersonmelo/claude-agent-experiments --skill listener-creator-edersonmelo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: listener-creator
Source: https://github.com/edersonmelo/claude-agent-experiments/tree/main/email-agent/agent/.claude/skills/listener-creator
Command: npx skills add https://github.com/edersonmelo/claude-agent-experiments --skill listener-creator-edersonmelo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you build event-driven email listeners that monitor for specific conditions and automatically trigger actions, reducing manual email-management work and enabling automation workflows.

Core Features & Use Cases

  • Define event-driven listeners that run as TypeScript files in agent/custom_scripts/listeners/.
  • Export a config object and a handler that processes Email events using the provided ListenerContext, with optional AI-powered analysis via context.callAgent().
  • Reusable templates and examples show how to detect urgency, auto-archive newsletters, or track packages, enabling rapid production-grade automation.

Quick Start

Create a new TypeScript listener in agent/custom_scripts/listeners that exports a config and a handler for email_received events, then enable and test it in the UI.

Frequently Asked Questions about listener-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate email notifications with event-driven listeners?

You create a TypeScript file in agent/custom_scripts/listeners that exports a config object and a handler. This handler processes email_received events using a ListenerContext, which you then enable and test directly in the UI.

Can I use AI to classify emails in my automation workflow?

Yes, TypeScript email listeners support optional AI-powered analysis via context.callAgent. This allows your handler to apply AI-assisted classification to detect urgency, auto-archive newsletters, or track packages within your automation workflow.

What do I need to build event-driven email listeners?

You need a TypeScript environment configured to run files in agent/custom_scripts/listeners. The workflow requires exporting a ListenerConfig object and a handler function that processes Email events using the provided ListenerContext.

What is the best way to set up real-time email event handling?

The best way to handle real-time email events is defining a TypeScript-based listener workflow. By exporting a config and handler for email_received events, you create a reusable, production-grade automation script that triggers actions immediately.

Are there templates available for common email automation tasks?

Yes, reusable templates and examples are provided for common tasks like detecting urgency, auto-archiving newsletters, or tracking packages. These templates enable rapid deployment of production-grade email automation workflows.