new-processor

Scaffold BullMQ job processors with worker, service, and test files.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/wordshepherd/colophony --skill new-processor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-processor
Source: https://github.com/wordshepherd/colophony/tree/main/.claude/skills/new-processor
Command: npx skills add https://github.com/wordshepherd/colophony --skill new-processor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the boilerplate code required to set up a new job processor for BullMQ, a robust queue system, saving developers significant time and reducing the chance of configuration errors.

Core Features & Use Cases

  • Scaffolds Worker: Creates the core worker file that processes jobs.
  • Generates Service: Provides a service file for enqueuing jobs.
  • Configures Queue: Integrates the new queue into the application's queue setup.
  • Includes Tests: Generates basic unit tests for the service.
  • Use Case: When adding a new background task like sending welcome emails, use this Skill to quickly generate all necessary files and configurations for the email-sending job processor.

Quick Start

Use the new-processor skill to scaffold a new BullMQ job processor named 'email-send'.

Frequently Asked Questions about new-processor

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

FAQPage Schema
How do I scaffold a new BullMQ job processor for my application?

Scaffolding a BullMQ job processor is automated by generating the worker, service, and test files while updating the queue constants and setup modules. This creates the necessary background job processing infrastructure for your application instantly.

What boilerplate code is needed to set up a BullMQ worker and service?

The required boilerplate includes a core worker file to process jobs and a service file for enqueuing jobs. You must also integrate the new queue into the application's queue setup module to complete the background processing infrastructure.

Does scaffolding a BullMQ queue processor also generate unit tests?

Yes, scaffolding a BullMQ queue processor generates basic unit tests for the service. These tests are automatically created alongside the worker and service files to validate the job enqueuing logic immediately.

What do I need to implement after generating BullMQ job processor files?

After generating BullMQ job processor files, you need to define the job data interfaces and implement the specific processing logic within the generated worker. The Skill provides the structural boilerplate, leaving the custom business logic for you to add.

When should I use a BullMQ job processor scaffolding tool?

Use a BullMQ job processor scaffolding tool when adding a new background task like sending welcome emails to automate file creation and reduce configuration errors. It quickly generates all necessary worker, service, and test configurations for the new job.