Ravenclaw Operations Skill

Category: Email Automation / Communication

Description: Operate the Ravenclaw Email Bridge — send emails, schedule future emails, check inbox, and manage email workflows. Forward POP3 emails to Discord webhooks with scheduled sending capabilities.

Maintainer: Ibrahim Qureshi (@ibrahimq21)

Tags: email, discord, webhook, automation, smtp, pop3, scheduled

Capabilities

• Send immediate emails via SMTP
• Schedule emails for future delivery
• Check inbox and unread emails
• Trigger manual email checks
• View scheduled email queue
• Cancel scheduled emails
• Health checks and statistics

Requirements

Local Setup (for direct operation)

Ravenclaw must be running:

# Start Ravenclaw bridge
cd path/to/ravenclaw
python ravenclaw.py

# Default port: 5002

Environment variables:

• RAVENCLAW_URL (optional): Custom URL for Ravenclaw API (default: http://localhost:5002)

Community Sharing

For users to use this skill:

1. They must have Ravenclaw installed locally
2. Ravenclaw must be running
3. Configuration via environment or RAVENCLAW_URL

Commands

Send Email

Send an immediate email.

Pattern:

send email to [recipient] with subject [subject] and body [body]

Example:

send email to [email protected] with subject "Leave Request" and body "I would like to take leave tomorrow."

Parameters:

• recipient (required): Email address
• subject (required): Email subject line
• body (required): Email content

API Call: POST /send

Schedule Email

Schedule an email to be sent at a specific time.

Pattern:

schedule email to [recipient] with subject [subject] and body [body] at [time]

Example:

schedule email to [email protected] with subject "Leave Application" and body "Requesting leave for next Monday" at "2026-02-23T09:00:00"

Parameters:

• recipient (required): Email address
• subject (required): Email subject line
• body (required): Email content
• time (required): ISO-8601 timestamp (e.g., 2026-02-23T09:00:00)

API Call: POST /schedule

Tips:

• Use format: YYYY-MM-DDTHH:MM:SS
• Time must be in the future
• High priority emails get more retry attempts

List Scheduled Emails

View all scheduled emails.

Pattern:

list scheduled emails
show scheduled emails

API Call: GET /schedule/list

Response includes:

• Total emails
• Pending count
• Full list with status, target time, recipient

Cancel Scheduled Email

Cancel a pending scheduled email.

Pattern:

cancel scheduled email [id]

Example:

cancel scheduled email sched_20260223100000_0

API Call: POST /schedule/cancel/<id>

Check Inbox

Trigger a manual inbox check.

Pattern:

check inbox
check emails

API Call: POST /check