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.