kanban-worker

Guides Hermes Kanban workers through task lifecycle pitfalls, handoffs, and retry diagnostics.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill kanban-worker-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kanban-worker
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/devops/kanban-worker
Command: npx skills add https://github.com/luckybbjason1/trading --skill kanban-worker-luckybbjason1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dispatched Kanban workers often fail silently or produce unusable handoffs: they claim cards they never created, block with vague reasons like "stuck", call interactive tools in headless runs, or repeat the exact approach that already timed out. This Skill provides the operational detail that prevents those failures. ## Core Features & Use Cases - Structured handoff patterns: Concrete kanban_complete summary and metadata shapes for coding, research, and review tasks, plus a review-required flow using kanban_comment plus kanban_block so human reviewers get full context. - Workspace and tenant handling: Rules for scratch, dir:, and worktree workspace kinds, and tenant-prefixed memory entries to prevent cross-tenant context leaks. - Retry and edge-case diagnostics: How to interpret prior run outcomes (timed_out, crashed, spawn_failed, reclaimed, blocked) and avoid repeating failed paths, plus heartbeat and block-reason conventions. - Use Case: A worker retrying a crashed task inspects kanban_show, sees outcome: "crashed", reduces memory footprint, completes with structured metadata, and claims only the card IDs captured from actual kanban_create return values. ## Quick Start Load the kanban-worker skill and follow its guidance to complete your dispatched Kanban task with a structured summary, verified created_cards, and a clear block reason if human input is needed.

Frequently Asked Questions about kanban-worker

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

FAQPage Schema
How do I complete a Kanban task as a Hermes worker agent?

Call kanban_complete with a concise summary and structured metadata such as changed_files, tests_run, and decisions so downstream workers can parse results. Only complete when the task is genuinely finished; otherwise block with a specific reason.

How do I request human review for code changes in a Kanban task?

Post the structured metadata (changed files, test counts, diff path) via kanban_comment, then call kanban_block with a reason prefixed "review-required: ". The reviewer unblocks the task, which re-spawns you with the comment thread.

Why does claiming created_cards fail on kanban_complete?

The kernel verifies every claimed card ID exists and was created by your profile. Only pass IDs captured from successful kanban_create return values; hallucinated or reused IDs cause the completion to be rejected and logged.

Can I use the clarify tool to ask questions in a headless Kanban run?

No. Headless workers have no live user, so clarify times out and leaves the task silently running. Use kanban_comment for context plus kanban_block with a specific decision question instead.

What should I do when retrying a previously failed Kanban task?

Run kanban_show first and inspect prior runs' outcome, summary, and error fields. Adjust based on the failure: chunk work after timed_out, reduce memory after crashed, and block for human help after spawn_failed rather than retrying blindly.

Does the hermes kanban CLI work inside containerized worker backends?

No. The CLI is not installed in Docker, Modal, or SSH backends, so it fails there. Use the kanban_* tools, which work across all terminal backends; the CLI exists only for human operators.