Kanban Markdown

A workflow skill for managing kanban boards stored as markdown files with YAML frontmatter in `.devtool/features/`. Each task lives in its own `.md` file with status, priority, assignee, and fractional index ordering that the VS Code kanban-markdown extension renders visually. The skill handles creating features with proper ID generation, moving them between columns (including the done subfolder), and maintaining exact serialization format so the extension can parse everything. It's built around very specific YAML formatting rules, five status columns, and lexicographic ordering for drag-and-drop positioning. Useful if you want plaintext project management that plays nicely with git and your editor.

skills.sh installs: 386
GitHub stars: 6
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add lachyfs/kanban-skill --skill kanban-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

Kanban Markdown

Manage kanban board features stored as markdown files with YAML frontmatter. Each feature is a .md file; the VS Code kanban-markdown extension renders them as a board.

File Format

Every feature file follows this exact format:

---
id: "my-feature-2026-02-20"
status: "backlog"
priority: "medium"
assignee: null
dueDate: null
created: "2026-02-20T10:00:00.000Z"
modified: "2026-02-20T10:00:00.000Z"
completedAt: null
labels: []
order: "a0"
---

# My Feature

Description and details here.

Serialization rules (must match exactly for the extension to parse correctly):

String fields: always "double-quoted"
Nullable fields (assignee, dueDate, completedAt): bare null when unset
Labels: inline array ["bug", "ui"] or []
Order: "double-quoted" string — fractional index for lexicographic sorting (see below)
Field order: id, status, priority, assignee, dueDate, created, modified, completedAt, labels, order