Initial commit: antigravity-claudekit

skills/ck-kanban/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: ck-kanban
+description: Launch a kanban dashboard for plans directory with progress tracking and Gantt timeline visualization. Use for viewing plan status, phase progress, milestone tracking, and project visibility.
+---
+
+# Kanban — Plans Dashboard
+
+Launches a visual kanban dashboard for a plans directory with progress tracking and timeline.
+
+## When to Use
+
+- Viewing progress across multiple implementation plans
+- Tracking phase statuses visually (completed, in-progress, pending)
+- Sharing a local project dashboard on the network
+
+## Don't Use When
+
+- Plans directory doesn't exist or has no `plan.md` files
+- Only need to read a single plan (read the file directly)
+
+## Usage
+
+```
+ck-kanban              # View dashboard for ./plans
+ck-kanban plans/       # View dashboard for specific directory
+ck-kanban --stop       # Stop running server
+```
+
+## Execution
+
+**Stop server** (if `--stop` flag provided):
+```bash
+node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --stop
+```
+
+**Start server** (run as background task with 5-minute timeout):
+```bash
+node $HOME/.claude/skills/plans-kanban/scripts/server.cjs \
+  --dir "$PLANS_DIR" \
+  --host 0.0.0.0 \
+  --open \
+  --foreground
+```
+
+Run in background mode with a 300000ms timeout to keep the process alive.
+
+## After Starting
+
+Parse the JSON output and report to user:
+- Local URL (e.g., `http://localhost:3500/kanban?dir=...`)
+- Network URL for remote device access (e.g., `http://192.168.x.x:3500/kanban?dir=...`)
+
+**Always display the FULL URL including path and query string — never truncate to just `host:port`.**
+
+## Features
+
+- Plan cards with progress bars
+- Phase status breakdown
+- Gantt-style timeline and activity heatmap
+- Issue and branch links
+- Priority indicators