What problem does it solve?
This Skill prevents stalled or inconsistent Kanban worker runs by standardizing workspace behavior, tenant-safe persistence, handoff summaries/metadata, and clear retry/block/heartbeat patterns.
Core Features & Use Cases
- Workspace handling: Correct behavior across
scratch, dir:<path> (persistent shared state), and worktree (Git worktrees with optional setup) to avoid corrupting or misreading artifacts.
- Tenant isolation: Guidance to prevent cross-tenant memory leakage by namespacing persistent entries with
$GENGAR_TENANT.
- Operational handoffs: Prescribes how to call
kanban_complete(...) with structured summary and machine-readable metadata so downstream reviewers/aggregators can consume results without rereading prose.
- Fast, actionable blocking: Defines how to use
kanban_block(...) plus contextual kanban_comment(...) so humans can answer quickly.
- Heartbeat and retry diagnostics: Recommends informative heartbeat content and explains how to interpret prior run outcomes to avoid repeating failing paths.
Quick Start
Load the kanban-worker skill when dispatched by the Kanban dispatcher (it is auto-injected for workers) and respond to each task by completing it with a kanban_complete(summary, metadata) that matches the recommended metadata shapes.