notification-system
/notification-system
Projektuje i wdraża wielokanałowe systemy powiadomień z dostarczaniem e-mail, push i w aplikacji: preferencje użytkownika, potoki dostarczania, ponowienia i routing między kanałami.
- Autor
- TerminalSkills ↗
- Repozytorium
- skills ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 25.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Projektuje i wdraża wielokanałowe systemy powiadomień z dostarczaniem e-mail, push i w aplikacji: preferencje użytkownika, potoki dostarczania, ponowienia i routing między kanałami.
Oryginalny opis (EN)
Designs and implements multi-channel notification systems with email, push, and in-app delivery. Use when you need to build a notification service, set up user notification preferences, create delivery pipelines, implement retry logic for failed notifications, or route messages across channels. Trigger words: notification system, push notifications, email notifications, in-app notifications, notification preferences, delivery tracking, unsubscribe, notification routing.
Jak działa
- Overview
- Instructions
- Examples
- Guidelines
Podgląd SKILL.md
---
name: notification-system
description: >-
Designs and implements multi-channel notification systems with email,
push, and in-app delivery. Use when you need to build a notification
service, set up user notification preferences, create delivery pipelines,
implement retry logic for failed notifications, or route messages across
channels. Trigger words: notification system, push notifications, email
notifications, in-app notifications, notification preferences, delivery
tracking, unsubscribe, notification routing.
license: Apache-2.0
compatibility: "Node.js 18+, Python 3.9+. Requires a message queue (Redis/BullMQ, RabbitMQ, or SQS) for production use."
metadata:
author: terminal-skills
version: "1.1.0"
category: development
tags: "notifications, messaging, email"
---
# Notification System
## Overview
This skill enables AI agents to architect, implement, and configure multi-channel notification systems. It covers channel routing, user preference management, template rendering across formats, delivery tracking, retry logic, and compliance requirements like CAN-SPAM unsubscribe.
## Instructions
### 1. Notification Architecture
Every notification system needs these components:
```
Event Source → Notification Router → Channel Adapters → Delivery
↓ ↓
Preference Store Retry Queue
↓
Dead Letter Queue
```
**Notification Router**: Receives a typed event, resolves the user's channel preferences, and dispatches to the appropriate channel adapters.
**Channel Adapters**: Pluggable handlers for each delivery channel. Must implement a common interface:
```typescript
interface ChannelAdapter {
channel: 'email' | 'push' | 'in-app';
send(notification: FormattedNotification): Promise<DeliveryResult>;
validateRecipient(userId: string): Promise<boolean>;
}
```
**Preference Store**: Database-backed user preferences with per-notification-type, per-channel toggles. Some notifications (transactional/security) must be non-disableable.
### 2. Notification Type Classification
Always classify notifications into categories that determine default behavior:
| Category | Examples | Can Disable? | Default Channels |
|----------|----------|-------------|-----------------|
| Security | Password reset, 2FA | No | Email |
| Transactional | Order confirm, receipt | No | Email + In-app |
| Activity | Comments, mentions | Yes | Push + In-app |
| Social | New follower, like | Yes | In-app |
| Marketing | Digest, announcements | Yes | Email |
### 3. Channel-Specific Constraints
**Email**:
- Commercial and marketing email needs an unsubscribe link and must honor opt-outs (CAN-SPAM, 15 U.S.C. 7704). CAN-SPAM does not treat transactional or relationship messages (receipts, password resets) as commercial email, but keep promotional content out of them
- Gmail requires one-click unsubscribe for subscribed and marketing mail. Send both `List-Unsubscribe: <https://terminalskills.io/unsubscribe/7f3c9a2e>` and `List-Unsubscribe-Post: List-Unsubscribe=One-Click` (RFC 8058). DKIM must sign both headers, and the POST handler must complete the unsubscribe itself, without a login or confirmation page
- Senders of 5,000 or more messages a day to Gmail must meet Google's bulk-sender rules (SPF or DKIM, PTR records, TLS, DMARC alignment)
- HTML + plain text versions
- Sender reputation — batch marketing emails separately from transactional
**Push Notifications**:
- Keep titles near 65 characters and bodies near 178: lock screens cut longer text, and the cut-off varies by OS and device. These are display guidance, not API limits; check your provider's payload size limit
- Include `data` payload for deep linking
- Handle token expiration and refresh
- Respect OS-level notification settings
**In-App**:
- Store in database with read/unread status
- Deliver in real-time via WebSocket if user is online
- Group related notifications (e.g., "3 people commented on your post")
- Paginate the notification feed
### 4. Retry and Failure Handling
Implement exponential backoff per channel:
- **Email**: 3 retries at 1min, 5min, 30min (provider outages are temporary)
- **Push**: 2 retries at 30s, 2min (invalid tokens should fail fast)
- **In-app**: 0 retries (direct DB write, either succeeds or doesn't)
After max retries, move to dead letter queue with full context for debugging.
### 5. Template Strategy
Use a single data context per notification type that renders differently per channel:
```typescript
interface NotificationContext {
type: 'new-comment';
actor: { name: string; avatarUrl: string };
target: { title: string; url: string };
content: { preview: string; full: string };
}
// → Email: Full HTML with actor avatar, comment preview, and action button
// → Push: "Alex commented: 'Great analysis of the…'"
// → In-app: "Alex commented on Your Post Title" with link
```
### 6. Delivery Tracking
Track these states for every notification:
`queued → sent → delivered → read → failed`
Store in a `notification_deliveries` table with: notification_id, user_id, channel, status, attempted_at, delivered_at, read_at, error_message.
## Examples
### Example 1: Express + BullMQ notification router
**Prompt**: "Build a notification service for my Express app that sends order confirmations via email and in-app."
**Output**: The agent creates a BullMQ-backed router that accepts `{ type: 'order-confirmed', userId, data: { orderId, total, items } }`, checks user preferences, and dispatches to the email adapter (SendGrid) and in-app adapter (PostgreSQL insert + Socket.io emit).
### Example 2: Preference management API
**Prompt**: "Create an API for users to manage their notification preferences with a React settings page."
**Output**: The agent generates REST endpoints for CRUD on notification preferences, a migration for the `notification_preferences` table with a composite unique constraint on (user_id, notification_type, channel), and a React component rendering a matrix of toggles with notification types as rows and channels as columns.
## Guidelines
- Never allow users to disable security notifications (password reset, 2FA codes)
- Always send email notifications from a queue, never synchronously in the request handler
- Batch notification grouping (e.g., "5 new comments") to avoid notification fatigue
- Test with notification-heavy scenarios: a user mentioned in a thread with 50 replies
- Include rate limiting on notifications per user per hour to prevent notification storms
- Log delivery metrics for monitoring: sent/delivered/failed rates by channel
Pliki w paczce (2)
- SKILL.md 7 KB
- _scores.json 3 KB
Wersje
W bazie nie ma innych skilli o nazwie notification-system.
Migawka bazy z 13.11.2026 · wersja paczki 8b5e39709600 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100push-notification-setup
Wdraża powiadomienia push na iOS, Android i w sieci przez Firebase Cloud Messaging oraz usługi natywne, w tym wiadomości w tle i kanały powiadomień. - 100a2a-push-notifications
Wdraża powiadomienia push A2A: rejestrację adresu callback i dostarczanie powiadomień dla długotrwałych zadań. - 100notifications
Konfiguruje sposób dostarczania powiadomień, w tym ustawienia alertów i konfigurację kanałów powiadomień. - 100orchardcore-notifications
Zarządza powiadomieniami w Orchard Core: wiadomościami, dostarczaniem przez e-mail i SMS, zdarzeniami oraz akcjami workflow. - 100push-notifications
Pomaga budować powiadomienia push w sieci i na urządzeniach mobilnych z Firebase Cloud Messaging, APNs, Web Push API i Expo Notifications oraz projektować ich architekturę. - 95push-notifications
Wdraża, przegląda i debuguje powiadomienia push w aplikacjach iOS i macOS: lokalne, zdalne APNs, rozbudowane, akcje, ciche powiadomienia i rozszerzenia usługi oraz treści.