Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

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.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Overview
  2. Instructions
  3. Examples
  4. Guidelines
Sekcje z nagłówków SKILL.md, w oryginale · 125 linii, 812 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.