kanban-dispatcher-stalled

Diagnose Kanban Dispatcher issues across launchd, jobs.json, and cron outputs.

2|7|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/humanerd-drew/opencode-drewgent --skill kanban-dispatcher-stalled
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kanban-dispatcher-stalled
Source: https://github.com/humanerd-drew/opencode-drewgent/tree/main/skills/kanban-dispatcher-stalled
Command: npx skills add https://github.com/humanerd-drew/opencode-drewgent --skill kanban-dispatcher-stalled

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires launchctl, python3, sqlite3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill quickly identifies and diagnoses issues with the Kanban Dispatcher, ensuring smooth operation of Kanban workflows.

Core Features & Use Cases

  • Fail Mode Detection: Identifies four common fail modes in Kanban Dispatcher operation.
  • Launchd Trigger Check: Verifies the presence of launchd plist files.
  • Script Path Validation: Checks for script files in the correct path.
  • Stale 'last_status=ok' Marker: Validates the 'last_status=ok' marker in jobs.json.
  • Dead Worker Reclamation: Detects and reclaims dead worker processes.
  • Recurring Job Next Run Check: Ensures recurring jobs have a valid 'next_run_at' value.
  • Sequential Tick Blocking by LLM Cron Job: Diagnoses and resolves issues caused by LLM cron jobs blocking sequential ticks.

Quick Start

Run the 'kanban-dispatcher-stalled' skill to diagnose and resolve Kanban Dispatcher issues.

Frequently Asked Questions about kanban-dispatcher-stalled

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

FAQPage Schema
Why is my Kanban Dispatcher stalling and missing scheduled launchd triggers?

Kanban Dispatcher stalling often stems from missing launchd plist files or script path mismatches. Diagnosing these issues involves verifying launchd trigger presence and validating that script files reside in the correct operational path to restore normal workflow execution.

How do I check for stale 'last_status=ok' markers in jobs.json?

To check for stale 'last_status=ok' markers in jobs.json, validate the marker's current state against active worker processes. This diagnostic step identifies inactive tasks incorrectly marked as successful, preventing dead worker reclaim failures and ensuring accurate recurring job scheduling.

What causes dead worker reclaim failures in a Kanban workflow?

Dead worker reclaim failures occur when inactive worker processes are not properly detected and reclaimed. Diagnosing this requires inspecting jobs.json and cron outputs to identify orphaned workers, allowing the dispatcher to clear stale status markers and resume sequential ticking.

Do I need python3 and sqlite3 to diagnose recurring job next_run_at issues?

Yes, diagnosing recurring job next_run_at issues requires python3 and sqlite3 to inspect the database and validate scheduling data. Access to launchctl and jobs.json outputs is also necessary to ensure recurring jobs have valid next run values and prevent sequential tick blocking.

How does an LLM cron job block sequential ticks in a Kanban Dispatcher?

An LLM cron job blocks sequential ticks by holding the dispatcher lock longer than expected. Diagnosing this involves analyzing cron outputs and jobs.json to detect the blocking process, resolve the deadlock, and restore sequential task progression.