superpowers-sage:acorn-queues

Configure Laravel queue workers and Action Scheduler for WordPress background jobs.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-acorn-queues-hekivo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:acorn-queues
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/acorn-queues
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-acorn-queues-hekivo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lando, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the challenge of running reliable background work in a WordPress (Roots Sage + Acorn) project without blocking HTTP requests, using either Laravel-style queues or WordPress-native Action Scheduler.

Core Features & Use Cases

  • Laravel Queue Jobs via Acorn: Dispatch ShouldQueue jobs with retries, backoff, job chaining, and batching for heavier async workloads (e.g., image processing, API syncs, bulk imports).
  • Action Scheduler for WP-native Background Tasks: Schedule single and recurring actions with as_schedule_single_action and as_schedule_recurring_action for simpler recurring workflows (e.g., daily cleanups, token maintenance, email digests).
  • Operational Guardrails & Debugging: Includes verification steps and failure-mode guidance (failed jobs tables, worker not running, Redis host inside Lando, sync driver safety).

Quick Start

Set QUEUE_CONNECTION=database, create a job class, run lando acorn queue:table and lando acorn migrate, then start the worker with bash skills/acorn-queues/scripts/run-worker.sh.

Frequently Asked Questions about superpowers-sage:acorn-queues

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

FAQPage Schema
How do I run WordPress background jobs with Acorn without blocking HTTP requests?

You can run WordPress background jobs with Acorn by enabling Laravel queue workers for async tasks or Action Scheduler for WP-native scheduled actions, preventing HTTP request blocking. This setup dispatches ShouldQueue jobs with retries and backoff.

Does Acorn queue processing support Redis with Lando?

Acorn queue processing supports Redis as a queue driver, including running the Redis host inside a Lando environment. You can select either the database or Redis driver in your Acorn queue configuration.

How do I set up Laravel queue workers for a Sage WordPress project?

To set up Laravel queue workers in a Sage project, set QUEUE_CONNECTION to database, run lando acorn queue:table and migrate, then start the worker using the provided run-worker script. This enables async job dispatching and batching.

What is the difference between Acorn queue jobs and Action Scheduler?

Acorn queue jobs handle heavier async workloads like image processing and bulk imports using retries and chaining, while Action Scheduler handles simpler WP-native recurring workflows like daily cleanups and email digests via WP cron callbacks.

Why are my Acorn queue jobs not processing or showing in the failed jobs table?

Acorn queue jobs may fail if the worker is not running, the sync driver is active, or Redis host configuration inside Lando is incorrect. Check failed jobs tables, verify worker status, and ensure safe driver selection.

Can I chain and batch background jobs in WordPress using Acorn?

You can chain and batch background jobs in WordPress using Acorn by dispatching properly designed ShouldQueue jobs. This allows sequential task execution and grouped batching for heavy workloads like API syncs.