# kanban-md

> Skills for kanban-md, a file-based kanban board CLI: your agent tracks tasks, and several agents claim and finish work in parallel.

kanban-md is an agent-first kanban board that lives in your repository as plain Markdown files, run by a single local binary with no database, server or account. These are its maker's Agent Skills: they teach your agent to manage the board and to work through it, so you can hand tasks to one or several agents and supervise them.

What its skills teach your agent
- kanban-md: create, list, filter, move, edit and delete tasks; read the board for a standup; check blocked and ready-to-start work, dependencies, metrics and the activity log; use compact output to save tokens
- kanban-based-development: a parallel-safe workflow where each agent claims a task, works in its own git worktree, implements and verifies the change, merges it, releases the claim and marks the task done, leaving a handoff note and deferring to you when a human decision is needed

How it works
- Install the CLI first (Homebrew: brew install antopolskiy/tap/kanban-md, or go install), then run kanban-md init in your project.
- kanban-md skill install adds the skills for detected agents; the maker documents Claude Code, Codex, Cursor and OpenClaw.
- Each task is a Markdown file in kanban/tasks/, so agents, people, scripts and Git all read the same board. kanban-md tui shows a live terminal board for supervising.
- Claims expire when an agent stops renewing them, which reduces duplicate work between cooperating agents.

Good to know
- Claims are coordination leases, not a security boundary: agents have to follow the protocol.
- The development workflow is written around the project's own Go tooling. The maker suggests adapting the local skill or AGENTS.md to your repository's build, review and release rules.
- The repository also ships skills the maintainer uses to develop kanban-md itself (releases, tests, output and format changes, feature review).
- A community project by antopolskiy, MIT licensed.

- Type: Skill
- Made by: antopolskiy
- Category: Project management
- Formats: Skills
- Version: latest
- Website: https://github.com/antopolskiy/kanban-md
- Source: https://github.com/antopolskiy/kanban-md
- Page: https://pluginboard.ai/skills/kanban-md

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the kanban-md folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Gemini

In Gemini: Download the kanban-md folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### GitHub Copilot

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.copilot/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.copilot/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.copilot/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.copilot/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.copilot/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.copilot/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.copilot/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Cursor

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.cursor/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.cursor/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.cursor/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.cursor/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.cursor/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.cursor/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.cursor/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Claude Code

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.claude/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.claude/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.claude/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.claude/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.claude/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.claude/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.claude/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Codex

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.agents/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.agents/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.agents/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.agents/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.agents/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.agents/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.agents/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Antigravity

In Antigravity: Copy the kanban-md folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Gemini CLI

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.gemini/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.gemini/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.gemini/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.gemini/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.gemini/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.gemini/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.gemini/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Replit

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output .agents/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats .agents/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development .agents/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md .agents/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner .agents/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md .agents/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md .agents/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### OpenClaw

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.openclaw/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.openclaw/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.openclaw/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.openclaw/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.openclaw/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.openclaw/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.openclaw/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### OpenCode

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.config/opencode/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.config/opencode/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.config/opencode/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.config/opencode/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.config/opencode/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.config/opencode/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.config/opencode/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

### Hermes Agent

Copy all 7 skills, in your terminal:

```shell
npx -y degit antopolskiy/kanban-md/.agents/skills/design-kanban-md-output ~/.hermes/skills/design-kanban-md-output
npx -y degit antopolskiy/kanban-md/.agents/skills/evolve-kanban-md-formats ~/.hermes/skills/evolve-kanban-md-formats
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-based-development ~/.hermes/skills/kanban-based-development
npx -y degit antopolskiy/kanban-md/internal/skill/skills/kanban-md ~/.hermes/skills/kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/kanban-md-principal-owner ~/.hermes/skills/kanban-md-principal-owner
npx -y degit antopolskiy/kanban-md/.agents/skills/release-kanban-md ~/.hermes/skills/release-kanban-md
npx -y degit antopolskiy/kanban-md/.agents/skills/test-kanban-md ~/.hermes/skills/test-kanban-md
```

View the skills on GitHub: https://github.com/antopolskiy/kanban-md

---
From Pluginboard (https://pluginboard.ai).
