Notification best practices skill

This skill provides comprehensive guidelines and best practices for designing, writing, and implementing effective notification systems across all channels.

Overview

The notification best practices skill includes six detailed rule sets covering:

Channel-specific notification guidelines - Specifications for email, push, SMS, in-app, and chat notifications
Notification copy best practices - Core principles for writing effective notification copy
Notification system implementation rules - Technical implementation guidelines including timing, preferences, error handling, and compliance
Notification template examples - Ready-to-use templates for common notification use cases
Transactional email best practices - Deliverability, templates, localization, and dynamic content for transactional emails
Welcome email best practices - Guidelines for crafting effective SaaS welcome emails

How to use this skill

For writing notifications

When you need to write notification copy:

Start with copy best practices (
```
rules/notification-copy-best-practices.md
```
)
- Follow core principles: be specific, include context, use active voice
- Choose the right tone and structure for your notification type
Check channel-specific guidelines (
```
rules/channel-specific-notifications-guidelines.md
```
)
- Verify character limits for your target channel
- Follow channel-specific formatting requirements
- Ensure your message fits the channel's constraints
Reference templates (
```
rules/notification-template-examples.md
```
)
- Find similar use cases to your notification
- Adapt template structure and variables
- Use provided examples as starting points

For email notifications

When working with email notifications:

Review transactional email best practices (
```
rules/transactional-email-best-practices.md
```
)
- Follow deliverability guidelines
- Use componentized templates and partials
- Implement proper localization
For welcome emails specifically (
```
rules/welcome-email-best-practices.md
```
)
- Choose the right pattern for your product
- Follow timing best practices
- Focus on value and clear CTAs

For system implementation

When implementing a notification system:

Follow system implementation rules (
```
rules/notification-system-implementation.md
```
)
- Understand channel selection criteria
- Implement proper timing and frequency controls
- Set up preference management
- Handle errors and retries correctly
- Ensure compliance with regulations
Use channel-specific guidelines for technical constraints
- Character limits
- Formatting requirements
- Delivery specifications

Rule files reference

rules/channel-specific-notifications-guidelines.md

- Channel specifications and constraints

rules/notification-copy-best-practices.md

- Writing principles and guidelines

rules/notification-system-implementation.md

- Technical implementation rules

```
rules/notification-template-examples.md
```
- Template library with examples

rules/transactional-email-best-practices.md

- Email-specific best practices

```
rules/welcome-email-best-practices.md
```
- Welcome email patterns and guidelines

Quick reference

Channel selection

Email: Persistent reference, detailed content, non-time-critical
Push: Time-sensitive, requires app return, urgent actions
SMS: Guaranteed delivery, authentication, extreme time-criticality
In-app: User active in product, can wait until next session
Chat: Team collaboration, immediate visibility needed

Copy principles

Be specific and actionable
Include maximum context
Use active voice
Maintain consistent terminology
Format for each channel

Common patterns

Transactional: Confirm what happened, include identifiers, provide next steps
System: Translate technical events to user impact, offer actionable steps
Lifecycle: Balance value with frequency, use social proof appropriately
Promotional: Lead with benefits, make offers specific and time-bound

Best practices summary

Always provide context - Users need enough information to decide whether to act
Respect channel constraints - Follow character limits and formatting requirements
Use appropriate timing - Consider immediate vs. batched vs. scheduled sends
Implement preferences - Give users control over notification types and channels
Test thoroughly - Verify across channels, devices, and with real data
Monitor and optimize - Track delivery, engagement, and user satisfaction metrics

notification-best-practices

NPX Install

Tags

SKILL.md Content