wp-background-processing
Installation
SKILL.md
WordPress Background Processing
Model note: Scaffolding a new Action Scheduler or
WP_Background_Processimplementation is pattern-matching —haikuhandles it well. Debugging a stuck queue or race condition across async jobs requires reasoning; usesonnet.
Implement background jobs and queued tasks in WordPress plugins. Three primary tools with distinct trade-offs: Action Scheduler (persistent, battle-tested), WP_Background_Process (lightweight, no DB table), WP Cron (built-in, unreliable timing).
When to use
- "Process a large batch of items in the background", "queue a long-running task".
- "Set up Action Scheduler", "use WooCommerce queue".
- "Implement WP_Background_Process", "chunked batch import".
- "Background email sending", "async API calls".
- "Fix a WP Cron job not firing", "make scheduled tasks reliable".
- "The scheduled action completes but nothing happens", "the handler only runs in the admin".
Not for: One-off scheduled events (use wp_schedule_single_event). REST API async patterns — use wp-rest-api.