kanban-worker

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill kanban-worker-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kanban-worker
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/devops/kanban-worker
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill kanban-worker-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dispatched Kanban workers often fail at handoffs: they claim cards they never created, write vague block reasons, send useless heartbeats, or mishandle retries and shared workspaces. This Skill provides the deeper operational detail beyond the auto-injected KANBAN_GUIDANCE lifecycle so workers complete, block, and hand off tasks correctly. ## Core Features & Use Cases - Structured handoff patterns: Concrete examples of kanban_complete summaries and metadata shapes for coding, research, and review tasks, including review-required flows using kanban_comment plus kanban_block. - Workspace and tenant handling: Rules for scratch, dir:, and git worktree workspaces, plus tenant-prefixed memory writes to prevent cross-tenant context leaks. - Retry and pitfall diagnostics: How to interpret prior run outcomes (timed_out, crashed, spawn_failed, reclaimed, blocked) and avoid repeating failed approaches. - Use Case: A worker finishes a rate-limiter implementation, posts structured metadata (changed files, test counts, decisions) as a comment, and blocks with a review-required: reason so a human reviewer can approve and unblock. ## Quick Start Load this skill when dispatched as a Hermes Kanban worker and follow its guidance to complete or block your assigned task with a well-formed summary and metadata.

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 with structured metadata?

Call kanban_complete with a concise summary and a metadata object containing machine-readable fields like changed_files, tests_run, and decisions. Shape the metadata so downstream reviewers and aggregators can parse it without re-reading your prose.

How should a Kanban worker handle code that needs human review?

Post the structured details (changed files, test counts, diff path) as a kanban_comment first, then call kanban_block with a reason prefixed 'review-required:'. A reviewer approves via hermes kanban unblock, which re-spawns you with the comment thread.

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 include ids captured from successful kanban_create return values; hallucinated or reused ids cause the completion to be rejected and logged.

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

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

Can I use the hermes kanban CLI inside a worker instead of the tools?

No, the CLI is not installed in containerized backends like Docker or Modal, so it will fail there. Use the kanban_* tools, which work across all terminal backends; the CLI exists for human operators.

When should a worker not call kanban_complete?

Do not complete tasks you did not actually finish, and avoid completing code changes that need human review. Block instead with a specific one-sentence reason, and put longer context in a comment.