communication

Files (22)

• SKILL.md
• clone-template.md · actions/
• delete-template.md · actions/
• get-mailbox-mail.md · actions/
• get-mailbox-mails.md · actions/
• get-notifications.md · actions/
• get-template.md · actions/
• get-templates.md · actions/
• get-unread-notifications.md · actions/
• mark-all-notifications-read.md · actions/
• mark-notification-read.md · actions/
• save-template.md · actions/
• send-email-to-any.md · actions/
• send-email-with-template.md · actions/
• send-notification.md · actions/
• contracts.md
• manage-templates-flow.md · flows/
• notification-flow.md · flows/
• send-email-flow.md · flows/
• frontend-blazor-tailwind.md
• frontend-blazor.md
• frontend-react.md

SKILL.md (first lines)

# Communication Skill

## Purpose

Handles all email sending, in-app notifications, and email template management for SELISE Blocks via the Communication v1 API.

Covers three sub-domains: Mail (send and retrieve emails), Notifier (push in-app notifications), and Template (create and manage email templates).

---

## When to Use

Example prompts that should route here:
- "Send a welcome email to new users using a template"
- "Build a notification bell with unread count"
- "Create an HTML email template for password resets"
- "Show me all sent emails in the mailbox"

---

## Execution Context

Before executing any action or flow from this skill, read `../core/execution-context.md` for the required supporting files, load order, and cross-domain orchestration rules.

---

## Intent Mapping

Use this table to route user requests. Check `flows/` first — if a flow covers the request, use it. For single-action requests, go directly to the action.

| User wants to... | Use |
|------------------|-----|
| Send email to a user | `flows/send-email-flow.md` → `actions/send-email-with-template.md` |
| Send email to any address | `flows/send-email-flow.md` → `actions/send-email-to-any.md` |
| Send notification to users | `flows/notification-flow.md` → `actions/send-notification.md` |
| View notifications | `flows/notification-flow.md` → `actions/get-notifications.md` |
| Mark notifications as read | `flows/notification-flow.md` → `actions/mark-notification-read.md` or `actions/mark-all-notifications-read.md` |
| Create or manage email templates | `flows/manage-templates-flow.md` → `actions/save-template.md` |
| List email templates | `flows/manage-templates-flow.md` → `actions/get-templates.md` |
| Get a specific email from mailbox | `actions/get-mailbox-mail.md` |
| List emails in mailbox | `actions/get-mailbox-mails.md` |
| Get unread notification count | `actions/get-unread-notifications.md` |
| Get a specific template | `actions/get-template.md` |
| Clone a template | `actions/clone-template.md` |
| Delete a template | `actions/delete-template.md` |

---

## Flows

| Flow | File | Description |
|------|------|-------------|
| send-email-flow | flows/send-email-flow.md | Send email via template or ad-hoc to any address |
| notification-flow | flows/notification-flow.md | Send, display, and mark in-app notifications as read |
| manage-templates-flow | flows/manage-templates-flow.md | Create, update, preview, clone, and delete email templates |

---

## Base Path

All endpoints are prefixed with: `$API_BASE_URL/communication/v1`

---

## Action Index

### Mail

| Action | File | Description |
|--------|------|-------------|
| send-email-to-any | actions/send-email-to-any.md | Send email to any address (ad-hoc, no template required) |
| send-email-with-template | actions/send-email-with-template.md | Send email to a registered user using a saved template |
| get-mailbox-mails | actions/get-mailbox-mails.md | Get paginated list of sent/received emails |
| get-mailbox-mail | actions/get-mailbox-mail.md | Get a specific email by ID |

### Notifier

| Action | File | Description |
|--------|------|-------------|
| send-notification | actions/send-notification.md | Send in-app notification to users by userId, role, or subscriptionFilter |
| get-unread-notifications | actions/get-unread-notifications.md | Get unread notifications for the current user by subscriptionFilter |
| mark-all-notifications-read | actions/mark-all-notifications-read.md | Mark all notifications as read for a subscriptionFilter |
| mark-notification-read | actions/mark-notification-read.md | Mark a single notification as read |
| get-notifications | actions/get-notifications.md | Get all notifications with pagination |

### Template

| Action | File | Description |
|--------|------|-------------|
| save-template | actions/save-template.md | Create or update an email template |
| get-template | actions/get-template.md | Get a single template by ID |
| get-templates | actions/get-templates.md | List all templates with search and sort |
| clone-template | actions/clone-template.md | Clone an existing template under a new name |
| delete-template | actions/delete-template.md | Delete a template by ID |

From rezwanx/blocks-ai-skills, MIT.

More from rezwanx/blocks-ai-skills