kanban-worker

Standardize Kanban worker execution with tenant-safe persistence and structured handoff summaries.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill kanban-worker-jamesfincher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kanban-worker
Source: https://github.com/JamesFincher/gengar/tree/main/skills/devops/kanban-worker
Command: npx skills add https://github.com/JamesFincher/gengar --skill kanban-worker-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about kanban-worker

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

FAQPage Schema
How do I standardize multi-agent Kanban workflow handoffs to prevent stalled runs?▼

Standardize multi-agent Kanban workflow handoffs by using structured `kanban_complete` summaries with machine-readable metadata. This prevents stalled runs by ensuring downstream agents receive actionable context without rereading prose.

What is the best way to isolate tenant data in persistent shared Kanban workspaces?▼

Isolate tenant data in persistent Kanban workspaces by namespacing entries with `$GENGAR_TENANT`. This prevents cross-tenant memory leakage when using `dir:<path>` or `worktree` workspace modes.

How do I block a Kanban task and request human intervention quickly?▼

Block a Kanban task and request human intervention by calling `kanban_block(...)` alongside a contextual `kanban_comment(...)`. This provides the exact context needed for humans to answer and resolve the block quickly.

How do I use retry diagnostics to avoid repeating failing paths in a Kanban workflow?▼

Use retry diagnostics in a Kanban workflow by leveraging `kanban_show` to interpret prior run outcomes. This allows you to avoid repeating failing paths by understanding previous execution failures before retrying.

Does the kanban-worker skill support Git worktrees for workspace management?▼

Yes, the kanban-worker skill supports Git worktrees for workspace management, including optional setup. It safely handles `scratch`, `dir:<path>`, and `worktree` modes to prevent corrupting or misreading artifacts.