faysilalshareef/email-notifications
skills/infra/email-notifications/SKILL.md
Use when implementing email sending with templates, SendGrid, or SES integration.
$ install --global
skillsauthnpx skillsauth add faysilalshareef/dotnet-ai-kit email-notificationsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 18, 2026, 3:09 AM136.1s1 file scanned
SKILL.md
- name:
- email-notifications
- description:
- Use when implementing email sending with templates, SendGrid, or SES integration.
- category:
- infra
- agent:
- dotnet-architect
- when_to_use:
- When implementing email service abstraction or notification templates
Email Notifications — Service Abstraction & Templates
Core Principles
IEmailServiceabstracts email sending from provider implementation- Support multiple providers: SendGrid, AWS SES, SMTP
- HTML templates with placeholder replacement
- Queue-based sending for reliability (fire-and-forget from handlers)
- Structured email models with strong typing
Key Patterns
Email Service Interface
namespace {Company}.{Domain}.Application.Interfaces;
public interface IEmailService
{
Task SendAsync(EmailMessage message, CancellationToken ct = default);
Task SendTemplatedAsync(string templateName, object model,
string toEmail, string? toName = null, CancellationToken ct = default);
}
public sealed record EmailMessage(
string ToEmail,
string ToName,
string Subject,
string HtmlBody,
string? PlainTextBody = null);
SendGrid Implementation
namespace {Company}.{Domain}.Infrastructure.Email;
public sealed class SendGridEmailService(
IOptions<EmailOptions> options,
ILogger<SendGridEmailService> logger) : IEmailService
{
private readonly SendGridClient _client = new(options.Value.ApiKey);
public async Task SendAsync(EmailMessage message, CancellationToken ct)
{
var msg = new SendGridMessage
{
From = new EmailAddress(options.Value.FromEmail, options.Value.FromName),
Subject = message.Subject,
HtmlContent = message.HtmlBody,
PlainTextContent = message.PlainTextBody
};
msg.AddTo(new EmailAddress(message.ToEmail, message.ToName));
var response = await _client.SendEmailAsync(msg, ct);
if (!response.IsSuccessStatusCode)
{
var body = await response.Body.ReadAsStringAsync(ct);
logger.LogError("SendGrid error: {Status} {Body}",
response.StatusCode, body);
}
}
public async Task SendTemplatedAsync(string templateName, object model,
string toEmail, string? toName, CancellationToken ct)
{
var template = await LoadTemplateAsync(templateName);
var html = RenderTemplate(template, model);
var subject = ExtractSubject(template, model);
await SendAsync(new EmailMessage(toEmail, toName ?? "", subject, html), ct);
}
private static string RenderTemplate(string template, object model)
{
var result = template;
foreach (var prop in model.GetType().GetProperties())
{
var value = prop.GetValue(model)?.ToString() ?? "";
result = result.Replace($"{{{{{prop.Name}}}}}", value);
}
return result;
}
}
Email Options
public sealed class EmailOptions
{
public const string SectionName = "Email";
[Required]
public string Provider { get; init; } = "SendGrid"; // SendGrid, SES, SMTP
[Required]
public string ApiKey { get; init; } = string.Empty;
[Required, EmailAddress]
public string FromEmail { get; init; } = string.Empty;
public string FromName { get; init; } = "{Company}";
}
Template Files
templates/
order-confirmation.html
welcome.html
password-reset.html
<!-- templates/order-confirmation.html -->
<html>
<body>
<h1>Order Confirmation</h1>
<p>Dear {{CustomerName}},</p>
<p>Your order #{{OrderNumber}} has been confirmed.</p>
<p>Total: {{Total}}</p>
</body>
</html>
Registration
services.AddOptions<EmailOptions>()
.BindConfiguration(EmailOptions.SectionName)
.ValidateDataAnnotations()
.ValidateOnStart();
services.AddScoped<IEmailService, SendGridEmailService>();
Anti-Patterns
| Anti-Pattern | Correct Approach | |---|---| | Direct SendGrid calls in handlers | Use IEmailService abstraction | | Synchronous email sending in request | Fire-and-forget via background job | | Hardcoded email content | Use HTML templates with placeholders | | Missing error handling | Log failures, don't throw to caller |
Detect Existing Patterns
# Find email service
grep -r "IEmailService\|EmailService" --include="*.cs" src/
# Find SendGrid/SES
grep -r "SendGrid\|SES\|SmtpClient" --include="*.cs" src/
# Find email templates
find . -name "*.html" -path "*/templates/*"
Adding to Existing Project
- Check for existing
IEmailService— extend, don't replace - Use the configured provider from EmailOptions
- Add new templates in the templates directory
- Queue emails via Hangfire or BackgroundJob for reliability
- Test with a sandbox — SendGrid has sandbox mode for testing
Related Skills
faysilalshareef/verification-gate
data-ai
VerifiedTrustedCommunity
Use when about to claim work is complete, fixed, passing, or ready — before committing, creating PRs, or moving to the next task. Requires running verification commands and confirming output before making any success claims.
2SKILL.mdUpdated Jun 1, 2026
faysilalshareef/systematic-debugging
development
VerifiedTrustedCommunity
Use when encountering any bug, test failure, build error, or unexpected behavior — before proposing fixes or making changes.
2SKILL.mdUpdated Jun 1, 2026
faysilalshareef/session-management
development
VerifiedTrustedCommunity
Use when checkpointing, wrapping up, or handing off an AI-assisted development session.
2SKILL.mdUpdated Jun 1, 2026
faysilalshareef/sdd-lifecycle
development
VerifiedTrustedCommunity
Use when following the Specification-Driven Development lifecycle from plan through ship.
2SKILL.mdUpdated Jun 1, 2026