Agent skill · operations · aiskillstore
email-notify
Send SMTP email notifications after Codex completes a task. Use when one Codex or Claude run is finished, or when you need to notify on task completion with device name, project name, status, and summary via email.
Why this skill is useful
Adds a Python script for sending email notifications with project-specific details that the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Email Notify Overview Send an email notification after each Codex task. Use the helper script to resolve the project name and send via SMTP. User Preparation 1) Configure environment variables Add the following lines to ~/.bashrc (Linux) or ~/.zshrc (macOS): If your SMTP server does not require auth, leave CODEXEMAILUSERNAME and CODEXEMAILPASSWORD unset. Set CODEXEMAILUSESSL to true for SMTPS (typically port 465) and CODEXEMAILUSETLS to true for STARTTLS. Do not set both CODEXEMAILUSETLS and CODEXEMAILUSESSL to true. 2) Add instruction in project AGENTS.md For example, add this instruction to AGENTS.md: Use skill email-notify to notify users when each agent run is finished or when any notifications would be sent to users. Workflow 1) Provide a project name source (optional) To override the folder name, define a project name in AGENTS.md using one of: YAML frontmatter: projectname: My Project (or name:) A plain line: Project Name: My Project If no name is found, the script uses the project folder name. 2) Send the notification at task completion Generate a short task title (3-8 words). Pick an execution status: success, failed, partial, blocked, etc. Write a brief result summary; avoid secrets. Run: Resources scripts/sendemailnotification.py: Send the email notification and resolve the project name.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/email-notify