Kanban Skill

kanban-ai

A Markdown-based Kanban board plugin for [Claude Code](https://claude.com/claude-code).

Cards live as `.md` files in a `kanban/` directory in your project. The board is derived at read-time — no database, no server. Status is tracked in YAML frontmatter.

Install

Requires Claude Code **v1.0.33+** (`claude --version` to check).

From a marketplace

If this plugin is available in a marketplace you've added:

/plugin install kanban@marketplace-name

From a local clone

Clone the repo and load it directly during development or personal use:

git clone https://github.com/mattjoyce/kanban-skill.git
claude --plugin-dir ./kanban-skill

You can also load multiple plugins at once:

claude --plugin-dir ./kanban-skill --plugin-dir ./other-plugin

Verify installation

Once loaded, run `/help` inside Claude Code. You should see `kanban:kanban-ai` listed. The skill is model-invoked, so Claude will use it automatically when you discuss tasks or kanban boards.

Usage

The skill is model-invoked — Claude will use it automatically when you ask about tasks, cards, or your kanban board. You can also trigger it explicitly:

> create a new kanban card for implementing user auth
> show me the board
> move card 3 to doing
> what cards are blocked?

The plugin stores cards in a `kanban/` directory in your project root. Create it if it doesn't exist — or Claude will create it for you.

Card Fields

Field	Required	Description
id	Yes	Auto-increment integer. Max existing + 1, start at 1.
status	Yes	backlog · todo · doing · done · archive

...