kanban-worker

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

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/i-bebsi/hermes-agent --skill kanban-worker-i-bebsi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kanban-worker
Source: https://github.com/i-bebsi/hermes-agent/tree/main/hermes-config/skills/devops/kanban-worker
Command: npx skills add https://github.com/i-bebsi/hermes-agent --skill kanban-worker-i-bebsi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dispatched Kanban workers often fail silently by mishandling workspaces, claiming cards they never created, blocking with vague reasons, or calling interactive tools in headless runs. This Skill documents the pitfalls, handoff shapes, and edge cases that keep multi-agent Kanban workflows reliable. ## Core Features & Use Cases - Workspace Handling: Defines correct behavior for scratch, shared directory, and git worktree workspaces, including tenant-isolated memory prefixes. - Structured Handoffs: Provides proven summary and metadata shapes for coding, research, and review tasks, plus review-required blocking patterns using kanban_comment and kanban_block. - Retry Diagnostics: Explains how to interpret prior run outcomes (timed_out, crashed, spawn_failed, reclaimed, blocked) so retries take a different path. - Use Case: A worker dispatched to fix a rate limiter completes its work, attaches changed files and test counts as structured metadata, and blocks with a review-required reason so a human reviewer can approve before merge. ## Quick Start Load the kanban-worker skill and follow its guidance to complete your assigned Kanban task with a structured summary and metadata handoff.

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. If the work needs human review, add a comment with the metadata and call kanban_block with a reason prefixed review-required instead.

How do I handle a git worktree workspace in a Kanban task?▼

Check whether .git exists in $HERMES_KANBAN_WORKSPACE. If not, run git worktree add with the resolved path and branch from HERMES_KANBAN_BRANCH, then cd into it and commit your work there.

Why does kanban_complete reject my created_cards list?▼

The kernel verifies every id in created_cards 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 Kanban worker run?▼

No. Workers run headless with 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 so the operator can unblock you.

What should I do when a Kanban task run is a retry?▼

Call kanban_show first and inspect prior runs' outcome, summary, and error fields. Adjust your approach based on the failure type, such as chunking work after timed_out or reducing memory after crashed, rather than repeating the same path.