jobs-and-notifications

Orchestrate Forge Jobs and Notifications for background work and multi-channel delivery.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/weiloon1234/Forge-Starter --skill jobs-and-notifications
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jobs-and-notifications
Source: https://github.com/weiloon1234/Forge-Starter/tree/main/.claude/skills/jobs-and-notifications
Command: npx skills add https://github.com/weiloon1234/Forge-Starter --skill jobs-and-notifications

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates background work and user-facing messaging by separating long-running tasks from immediate responses and enabling multi-channel delivery through Jobs and Notifications.

Core Features & Use Cases

  • Defers heavy tasks to background workers (e.g., image processing, report generation, webhook retries) to keep the request path responsive.
  • Delivers messages to recipients across channels (email, in-app/database inbox, and real-time WebSocket broadcasts).
  • Supports per-user routing via Notifiable implementations and a stable notification_type contract for tracking and filtering.
  • Distinguishes between Jobs (work units) and Notifications (recipient-facing messages), with both sync and queued dispatch options.

Quick Start

Trigger a welcome notification and a background job after a new user signs up.

Frequently Asked Questions about jobs-and-notifications

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send email and database notifications to users in the background?▼

To send email and database notifications in the background, defer the task using queued dispatch, route messages per-user via Notifiable implementations, and deliver across configured channels like in-app inbox and WebSocket.

What is the difference between background jobs and user notifications?▼

Background jobs handle deferred work units like report generation to keep request paths responsive, while user notifications route recipient-facing messages across email, database inbox, and WebSocket channels.

How do I keep API requests responsive when processing heavy tasks like image processing?▼

Keep API requests responsive by deferring heavy tasks like image processing to background job workers using async queued dispatch, separating long-running execution from the immediate request path.

Can I broadcast real-time WebSocket messages alongside email and in-app notifications?▼

Yes, you can broadcast real-time WebSocket messages alongside email and in-app database inbox delivery by rendering multiple channels within a single notification dispatched to specific recipients.

Does this notification system support retry and timeout for queued jobs?▼

Yes, the system provides explicit guidance on retry and timeout configurations for queued dispatch, ensuring background jobs and notifications handle failures gracefully without blocking the main execution.

When should I use sync dispatch instead of queued dispatch for notifications?▼

Use sync dispatch for immediate message delivery when latency is acceptable, and switch to queued dispatch for background work or multi-channel notifications to avoid blocking the request path.