migrate-kanban

Migrates flat tasks directories into a five-state Kanban folder structure.

6|Updated May 18, 2026
One-click install
npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill migrate-kanban-mokhtarabadi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-kanban
Source: https://github.com/mokhtarabadi/cognitive-lead-hq/tree/main/skill-templates/migrate-kanban
Command: npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill migrate-kanban-mokhtarabadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams upgrading to the V6 Kanban workflow often have a flat tasks/ directory full of markdown files with no state organization. Manually sorting dozens of task files into backlog, in-progress, qa, completed, and archive folders is tedious and error-prone, and naive moves lose git history. ## Core Features & Use Cases - Automated Directory Setup: Creates the five Kanban subdirectories (backlog, in-progress, qa, completed, archive) if they do not exist. - Status-Based Classification: Reads each task file's frontmatter or body for Status: open or Status: closed markers and routes files to the correct folder, defaulting unknown files to backlog. - History-Preserving Moves: Uses git mv so all task file history is retained through the migration. - Use Case: After adopting the V6 orchestration workflow, run this once to reorganize an existing repository's 40 flat task files into the Kanban structure, then update AGENTS.md references. ## Quick Start Ask the agent to migrate the flat tasks directory into the V6 Kanban folder structure using the migrate-kanban skill.

Frequently Asked Questions about migrate-kanban

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a flat tasks directory to a Kanban folder structure?▼

Create the five Kanban subdirectories (backlog, in-progress, qa, completed, archive), scan each markdown file for its status marker, and move files with git mv into the matching folder. Files with Status open go to backlog and Status closed go to completed.

How are task files classified during the Kanban migration?▼

Each file is checked for a Status: open or Status: closed marker in its frontmatter or body. Open files move to tasks/backlog, closed files move to tasks/completed, and files without any status default to tasks/backlog.

Does migrating task files preserve git history?▼

Yes. The migration uses git mv instead of plain mv, so git tracks the moves as renames and the full commit history of every task file is preserved after reorganization.

What happens to task files without a status field?▼

Files with no detectable status marker are moved to tasks/backlog by default. The tasks/README.md file is explicitly skipped and left in place during the migration.

What should I update after running the Kanban migration?▼

Update AGENTS.md so the Core File Locations and Documentation Sync Rules sections reference the new Kanban directory structure. Then verify the migration by listing the contents of tasks/backlog and tasks/completed.