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.