Agent skill

Kanban

by iii-hq in iii-hq/workers

File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling.

Apache-2.0Auto-check passedProductivity & Automation

Install Kanban

skills CLI
$ npx skills add iii-hq/workers --skill kanban -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install iii-hq/workers kanban --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/iii-hq/workers.git skills-src && mkdir -p .claude/skills && cp -r skills-src/kanban/skills .claude/skills/kanban && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kanban
GitHub stars
113
Token cost
~1.4k tokens
SKILL.md length
746 words
Files
22
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling.

  • Works in 2 steps: Register a handler, or omit function_id… → Register the trigger
  • Instead of polling
  • SKILL.md covers When to Use, Boundaries, Functions and Reactive triggers
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Kanban is an agent skill from iii-hq/workers. File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling. Reach for it whenever work is planned, dispatched, reported or reviewed as tickets.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files (for example `ade-worker-design/console-design.md`, `ade-worker-design/console-injectable-ui.md` and `ade-worker-design/index.md`).

It sits in Productivity & Automation, covering Task management and Sprint planning and agile. The licence is Apache-2.0.

When your agent uses it

  • Instead of polling
  • Tasks that involve Task management
  • Tasks that involve Sprint planning and agile

Example prompts

  • “/kanban”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Register a handler, or omit function_id from an agent session to be woken.
  2. Register the trigger

What it can do on your machine

Read from SKILL.md and the folder at commit ebfe027. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kanban loads about 1.4k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 746 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from iii-hq/workers at commit ebfe027, republished under its Apache-2.0 licence (© iii-hq). 746 words, ~1,437 tokens.

Download SKILL.mdSave it as .claude/skills/kanban/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
kanban
description
File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling. Reach for it whenever work is planned, dispatched, reported or reviewed as tickets.

kanban

The kanban worker owns one board file (<data_path>/board.json) holding every ticket with its comments and activity timeline inline. Every ticket carries an internal uuid and a human key (KAN-7, case-insensitive); both work everywhere a ticket is addressed. Columns, priorities and the key prefix are configuration (kanban::config::info prints the live values), and the default board is backlog, todo, in_progress, in_review, done.

Tickets are never removed by an agent: a finished ticket is moved to in_review or done, and a human soft-deletes from the console's ticket screen (the row stays on disk with deleted_at set). Writes take an actor and comments an author; pass your own agent-profile id in both, because the comment filters below key on exactly that string. The worker also injects a board page and a ticket page into the console.

When to Use

  • A feature is being planned, dispatched to other agent profiles, or reviewed, and the plan must outlive the chat session.
  • You were dispatched onto a ticket and must claim it, report on it and hand it off where the reviewer will see it.
  • You need to react to a human's or another agent's comment on one ticket without polling.
  • The console should show a board or a ticket beside the conversation.

Boundaries

  • Not a general task queue or a durable job store; use queue for work that must be executed, and the board for work that must be planned and reviewed.
  • No author filter on kanban:change; use kanban:comment with exclude_author for a feedback loop that must not wake on your own posts.
  • Deleting and restoring tickets is the human's action; agents move tickets.
  • Agent profiles are resolved through iii-directory (with the configured agents folder as the fallback); this worker does not create profiles.

Functions

  • kanban::config::info — resolved settings: board file path, columns, priorities, key prefix, agents folder.
  • kanban::board::get — every column with its ticket summaries; statuses, updated_since, limit and compact keep the read small.
  • kanban::ticket::create — create a ticket (title, description, status, priority, assignee, labels, actor).
  • kanban::ticket::get — one ticket with comments and activity, by uuid or key.
  • kanban::ticket::list — ticket summaries narrowed by column, assignee or updated_since; compact rows for catch-up reads.
  • kanban::ticket::update — change title, description, status, priority, assignee or labels.
  • kanban::ticket::move — move a ticket to a column and position (the board drag and drop).
  • kanban::ticket::delete / kanban::ticket::restore — soft delete and undo; human actions.
  • kanban::comment::create — comment or reply (parent_id); replies stay one level deep.
  • kanban::comment::list — comments filtered by author, excluded author, root only, or since a timestamp.
  • kanban::activity::list — the ticket's timeline, oldest first, optionally narrowed by type or time.
  • kanban::agent::list — assignable agent profiles and their ids.

A user may mention a ticket in chat as @kanban(id="<uuid>"); the message then arrives with a <mentions> block carrying the ticket's summary and the pre-verified kanban::ticket::get call. To point the user at a ticket in a reply, write @kanban(id="<uuid>") with the id a function returned — the console renders it as a ticket pill. (kanban::mention::search and kanban::mention::get serve the composer and that block; they are internal.)

Show full SKILL.md (254 more words)Show less

Reactive triggers

Register a kanban:comment trigger when a session or function should run every time someone comments on one ticket — the reviewer's answer after a hand-off, a human's reply, another agent's note — without re-reading the board.

Reach for it when:

  • You reported on a ticket and moved it to in_review, and the rejection or acceptance must reach you after your turn ended.
  • You dispatched a ticket to another profile and its report arrives as a comment.

If you only need the comment you just wrote, use the return value of kanban::comment::create; register a trigger only when a different author should wake you. kanban:change is the board-wide sibling: it fires on every event (ticket.created, ticket.updated, ticket.moved, ticket.deleted, ticket.restored, comment.created) with the whole ticket, filtered by ticket and event name only, and is the right primitive for keeping a view in sync or for a done-watch on ticket.moved.

How to bind
  1. Register a handler, or omit function_id from an agent session to be woken.
  2. Register the trigger:
json
engine::register_trigger {
  "trigger_type": "kanban:comment",
  "config": { "ticket_id": "KAN-7", "exclude_author": "<your profile id>", "ticket": "summary" },
  "once": false,
  "lifecycle": { "max_fires": 20, "expires_in_ms": 3600000 }
}

ticket_id is required and matches the uuid or the key; author, exclude_author and root_only narrow further. "ticket": "summary" on either trigger type delivers the board-card fields instead of the whole ticket with its thread — the right choice for an agent that re-reads the ticket on a wake. Mutations fire triggers; reads do not. The worker delivers only to bindings in its own in-process map, so pair a standing wake with a cron check-in over kanban::comment::list. For the payload shape call get function info on the trigger type.

© iii-hq, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 21 other files in kanban/skills of iii-hq/workers.

  • SKILL.md
  • ade-worker-design/console-design.md
  • ade-worker-design/console-injectable-ui.md
  • ade-worker-design/index.md
  • ade-worker-design/patterns.md
  • frontend/frontend-testing.md
  • frontend/iii-browser-sdk.md
  • frontend/index.md
  • frontend/react.md
  • frontend/tanstack-query.md
  • frontend/tanstack-router.md
  • frontend/vite.md
  • frontend/web-accessibility.md
  • frontend/web-performance.md
  • iii-node/configuration.md
  • iii-node/index.md
  • tickets/acceptance-review.md
  • … and 5 more

Open the folder on GitHubat commit ebfe027

Compare with similar skills

Kanban next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kanban compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kanban this skilliii-hq/workers113—~1.4kAutomated safety check: PassApache-2.0
Kanban Heartbeatcyanluna-git/cyanluna.skills183—~2.7kAutomated safety check: PassMIT
Frappe Impl UI ComponentsImpertio-Studio/Frappe_Claude_Skill_Package189—~4.2kAutomated safety check: PassMIT
Worklog Synccyanluna-git/cyanluna.skills183—~3.2kAutomated safety check: PassMIT
Wrongstack KanbanWrongStack/WrongStack371—~2.5kAutomated safety check: PassMIT
Kanban Mdantopolskiy/kanban-md223—~4kAutomated safety check: PassMIT

Similar skills

  • Kanban Heartbeat

    cyanluna-git/cyanluna.skills

    Scan kanban boards for stagnant tasks and optionally mark them.

    183 GitHub stars~2.7k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Frappe Impl UI Components

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when building custom dialogs, extending List View, creating Page controllers, or adding Kanban/Calendar views and realtime updates.

    189 GitHub stars~4.2k tokensUpdated 23 days ago
    Productivity & AutomationAuto-check passed
  • Worklog Sync

    cyanluna-git/cyanluna.skills

    Sync kanban board tasks to EOB weekly worklogs. An agent skill from cyanluna-git/cyanluna.skills.

    183 GitHub stars~3.2k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Wrongstack Kanban

    WrongStack/WrongStack

    Record substantial project work on WrongStack's IPC-backed Kanban board so it survives the session and other agents can see it.

    371 GitHub stars~2.5k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Kanban Md

    antopolskiy/kanban-md

    Manage project tasks using kanban-md, a file-based kanban board CLI.

    223 GitHub stars~4k tokensUpdated 5 days ago
    Productivity & AutomationAuto-check passed
  • Herdr Board

    nelsonPires5/herdr-board

    Interact with the herdr-board kanban from inside an agent run or an interactive session.

    173 GitHub stars~4.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from iii-hq/workers

All 19 skills in this repo
  • Cron

    iii-hq/workers

    Schedule any registered function on a 6- or 7-field cron expression with the standalone cron worker.

    113 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Email

    iii-hq/workers

    Send and read email from the iii engine — SMTP send, IMAP read, and real-time IDLE push as a subscribable trigger type.

    113 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • HTTP

    iii-hq/workers

    Expose registered functions as HTTP endpoints with the standalone http worker.

    113 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Pubsub

    iii-hq/workers

    DEPRECATED (will be removed in an upcoming release; migration guide https://iii.dev/docs/upgrading/migrate-from-streams).

    113 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Release Sync

    iii-hq/workers

    Organize worker release tags into Linear release waves — one team document plus one release/<date label per same-day batch of worker releases, with shipped MOT issues labeled and linked.

    113 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • State

    iii-hq/workers

    Shared, adapter-backed key/value store addressed by scope and key, with a reactive state trigger so other functions can run on every create, update, or delete without polling.

    113 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Kanban

What does Kanban do?

File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling. Kanban is an agent skill from iii-hq/workers. File-backed kanban board: create, read, move and comment on tickets by key or uuid, assign agent profiles, and wake on comments through the kanban:comment trigger instead of polling.

When should I use Kanban?

Kanban fits situations like: instead of polling; tasks that involve Task management; tasks that involve Sprint planning and agile.

How do I install Kanban in Claude Code?

Run `npx skills add iii-hq/workers --skill kanban -a claude-code`. Or copy the skill folder (kanban/skills in iii-hq/workers) into .claude/skills/kanban in your project. Claude Code loads it when a task matches its description.

How do I install Kanban in Codex?

Run `npx skills add iii-hq/workers --skill kanban -a codex`. Or copy the skill folder (kanban/skills in iii-hq/workers) into .agents/skills/kanban in your project. Codex loads it when a task matches its description.

Can I use Kanban in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add iii-hq/workers --skill kanban -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kanban, .gemini/skills/kanban, .github/skills/kanban and .opencode/skills/kanban in your project.

What does Kanban need to run?

SKILL.md names no scripts, command-line tools or credentials: Kanban is instructions for the agent only.

Does Kanban access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kanban safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kanban use?

Kanban is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kanban use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kanban?

Skills that share tags, products or a category with Kanban: Kanban Heartbeat (cyanluna-git/cyanluna.skills, 183 stars), Frappe Impl UI Components (Impertio-Studio/Frappe_Claude_Skill_Package, 189 stars), Worklog Sync (cyanluna-git/cyanluna.skills, 183 stars) and Wrongstack Kanban (WrongStack/WrongStack, 371 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kanban?

iii-hq (a GitHub organization) maintains it in iii-hq/workers, which has 113 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 10, 2026.

Source: iii-hq/workers on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.