antigravity-claudekit/skills/ck-plans-kanban/SKILL.md

name, description

name	description
ck-plans-kanban	View plans dashboard with progress tracking and Gantt timeline. Use for kanban boards, plan status overview, phase progress visualization, and milestone tracking across plan directories.

Plans Kanban Dashboard

Visual dashboard for plan directories with progress tracking, Gantt timeline, and activity heatmap.

When to Use

• Viewing progress across multiple implementation plans
• Tracking phase statuses (completed, in-progress, pending)
• Visualizing plan timelines and activity
• Monitoring milestone completion

Don't Use When

• Managing individual tasks within a single file (edit the plan.md directly)
• Real-time agent orchestration (not yet supported)

Installation Required

cd $HOME/.claude/skills/plans-kanban
npm install  # installs gray-matter dependency

Usage

# Start dashboard for ./plans directory
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --open

# Remote access (all interfaces)
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --host 0.0.0.0 --open

# Background mode
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --background

# Stop all running servers
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --stop

CLI Options

Option	Description	Default
--dir <path>	Plans directory	required
--port <n>	Server port	3500
--host <addr>	Host to bind	localhost
--open	Auto-open browser	false
--background	Run in background	false
--stop	Stop all servers	-

Plan Structure Required

Plans directory must contain subdirectories with plan.md files:

plans/
├── 251215-feature-a/
│   ├── plan.md          # Required - parsed for phases
│   └── phase-01-setup.md
└── 251214-feature-b/
    └── plan.md

HTTP Routes

Route	Description
/ or /kanban	Dashboard view
/api/plans	JSON API for plans data

Features

• Plan cards with progress bars
• Phase status breakdown
• Gantt-style timeline
• Activity heatmap
• Issue and branch links

Troubleshooting

• Port in use: Server auto-increments from 3500-3550
• No plans found: Ensure directories contain plan.md files
• Remote access denied: Use --host 0.0.0.0
• Error 500: Run npm install in skill directory first