assets

Name: assets
Author: Zaloog

264stars14forks

How to install assets?

zaloog/kanban-tui/assets

$npx -y skills add Zaloog/kanban-tui --skill assets

Installs into the current project.

Summary

Comprehensive kanban board and task management via ktui CLI. Use for project tracking, todo lists, task dependencies, workflow automation, and board management. Activates when user mentions boards, tasks, kanban, or project management. If the ktui command is not available, but

Files · 1

View on GitHub

SKILL.md

1	# Kanban-TUI: Terminal-Based Task Management System
2
3	You are an expert at using `ktui` (kanban-tui), a powerful CLI tool for managing kanban boards, tasks, and workflows. This skill enables you to help users organize projects, track tasks, manage dependencies, and automate workflows through a local SQLite-backed system.
4
5	## Core Concepts
6
7	### Data Model
8	- Boards: Workspaces for different projects (e.g., "Frontend", "API Development")
9	- Columns: Workflow stages within boards (e.g., "Backlog", "In Progress", "Review", "Done")
10	- Tasks: Work items that move through columns, can have dependencies on other tasks
11	- Active Board: The currently selected board where operations execute (unless `--board` specified)
12	- Special Columns: Each board has `reset_column` (default start), `start_column` (in-progress), `finish_column` (completion)
13
14	### Key Principles
15	1. CLI-Interface only: Never run bare `ktui`, use `ktui task/board/column ...` commands only
16	2. ID-Based Operations: All entities use numeric IDs - always list first to get IDs
17	3. JSON-First: Use `--json` flag for machine-readable output in automation
18	4. Active Board Context: Operations apply to active board unless explicitly specified
19	5. Non-Interactive: Use `--no-confirm` for automation/scripting
20
21	## When to Activate This Skill
22
23	Automatically activate when the user:
24	- Mentions "kanban", "board", "task management", "project tracking", or "todo"
25	- Asks to create, list, update, move, or delete tasks/boards
26	- Needs workflow automation with task dependencies
27	- Wants to query actionable items or task status
28	- Requests project planning or work organization
29	- Discusses task priorities, due dates, or blockers
30
31	## Command Categories & Workflows
32
33	### 1. Board Management
34
35	#### List All Boards
36	```bash
37	ktui board list --json
38	```
39	Output: Array of boards with `board_id`, `name`, `icon`, `creation_date`, `reset_column`, `start_column`, `finish_column`
40	Note: Active board shown in output header (look for "Active Board: ...")
41
42	#### Create Board
43	```bash
44	ktui board create "Board Name" --icon "🚀" --set-active -c "Col1" -c "Col2", -c "Col3"
45	```
46	Options:
47	- `--set-active`: Immediately activate this board
48	- `-c "Col1" -c "Col2", -c "Col3"`: Custom columns (default: "Ready, Doing, Done, Archive").
49	- `--icon`: Optional emoji icon for visual identification
50
51	#### Update Board
52	```bash
53	ktui board update BOARD_ID --name "New Name" --icon "🎨"
54	```
55	Note: Only specified fields are updated; others remain unchanged
56
57	#### Switch Active Board
58	```bash
59	ktui board activate BOARD_ID
60	```
61	Critical: Always verify active board before task operations
62
63	#### Delete Board
64	```bash
65	ktui board delete BOARD_ID --no-confirm
66	```
67	Warning: Deletes all associated tasks and columns, as an agent always use `--no-confirm`
68
69	### 2. Category Management
70
71	#### List All Categories
72	```bash
73	ktui category list --json
74	```
75	Output: Array of categories with `category_id`, `name`, `color`
76
77	#### Create Category
78	```bash
79	ktui category create "Category Name" "color"
80	```
81	Options:
82	- `color`: Optional. If omitted, a color is automatically assigned.
83	Note: Color must be a valid CSS/X11 color name or hex code (e.g., "red", "#FF0000").
84
85	#### Update Category
86	```bash
87	ktui category update CATEGORY_ID --name "New Name" --color "new-color"
88	```
89	Note: Only specified fields are updated; others remain unchanged
90
91	#### Delete Category
92	```bash
93	ktui category delete CATEGORY_ID --no-confirm
94	```
95	Impact: Resets the category of all associated tasks to null, as an agent always use `--no-confirm`
96
97	### 3. Task Management
98
99	#### List Tasks
100	```bash
101	ktui task list --json
102	```
103	Filters:
104	- `--column COLUMN_ID`: Tasks in specific column
105	- `--board BOARD_ID`: Tasks on specific board
106	- `--actionable`: Only non-blocked tasks (no unfinished dependencies)
107
108	Output Fields: `task_id`, `title`, `description`, `column_id`, `board_id`, `due_date`, `category_id`, `depends_on` (array), `creation_date`
109
110	#### Create Task
111	```bash
112	ktui task create "Task Title" --description "Details" --column COLUMN_ID --category CATEGORY_ID --due-date 2026-01-20 --depends-on TASK_ID
113	```
114	Options:
115	- `--column`: Target column ID (omit for leftmost visible column of active board)
116	- `--category`: Category ID to assign to the task
117	- `--due-date`: Format MUST be `YYYY-MM-DD` (e.g., "2026-01-20")
118	- `--depends-on`: Dependency task ID (use multiple times for multiple dependencies)
119
120	Example Multi-Dependency:
121	```bash
122	ktui task create "Deploy to prod" --depends-on 5 --depends-on 7 --depends-on 9
123	```
124
125	Note: To create tasks on other boards, only use the `--colu

People who liked this also viewed

6 picks

Type

assets

264stars14forks

View on GitHub

How to install assets?

zaloog/kanban-tui/assets

$npx -y skills add Zaloog/kanban-tui --skill assets

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Kanban-TUI: Terminal-Based Task Management System
2
3	You are an expert at using `ktui` (kanban-tui), a powerful CLI tool for managing kanban boards, tasks, and workflows. This skill enables you to help users organize projects, track tasks, manage dependencies, and automate workflows through a local SQLite-backed system.
4
5	## Core Concepts
6
7	### Data Model
8	- Boards: Workspaces for different projects (e.g., "Frontend", "API Development")
9	- Columns: Workflow stages within boards (e.g., "Backlog", "In Progress", "Review", "Done")
10	- Tasks: Work items that move through columns, can have dependencies on other tasks
11	- Active Board: The currently selected board where operations execute (unless `--board` specified)
12	- Special Columns: Each board has `reset_column` (default start), `start_column` (in-progress), `finish_column` (completion)
13
14	### Key Principles
15	1. CLI-Interface only: Never run bare `ktui`, use `ktui task/board/column ...` commands only
16	2. ID-Based Operations: All entities use numeric IDs - always list first to get IDs
17	3. JSON-First: Use `--json` flag for machine-readable output in automation
18	4. Active Board Context: Operations apply to active board unless explicitly specified
19	5. Non-Interactive: Use `--no-confirm` for automation/scripting
20
21	## When to Activate This Skill
22
23	Automatically activate when the user:
24	- Mentions "kanban", "board", "task management", "project tracking", or "todo"
25	- Asks to create, list, update, move, or delete tasks/boards
26	- Needs workflow automation with task dependencies
27	- Wants to query actionable items or task status
28	- Requests project planning or work organization
29	- Discusses task priorities, due dates, or blockers
30
31	## Command Categories & Workflows
32
33	### 1. Board Management
34
35	#### List All Boards
36	```bash
37	ktui board list --json
38	```
39	Output: Array of boards with `board_id`, `name`, `icon`, `creation_date`, `reset_column`, `start_column`, `finish_column`
40	Note: Active board shown in output header (look for "Active Board: ...")
41
42	#### Create Board
43	```bash
44	ktui board create "Board Name" --icon "🚀" --set-active -c "Col1" -c "Col2", -c "Col3"
45	```
46	Options:
47	- `--set-active`: Immediately activate this board
48	- `-c "Col1" -c "Col2", -c "Col3"`: Custom columns (default: "Ready, Doing, Done, Archive").
49	- `--icon`: Optional emoji icon for visual identification
50
51	#### Update Board
52	```bash
53	ktui board update BOARD_ID --name "New Name" --icon "🎨"
54	```
55	Note: Only specified fields are updated; others remain unchanged
56
57	#### Switch Active Board
58	```bash
59	ktui board activate BOARD_ID
60	```
61	Critical: Always verify active board before task operations
62
63	#### Delete Board
64	```bash
65	ktui board delete BOARD_ID --no-confirm
66	```
67	Warning: Deletes all associated tasks and columns, as an agent always use `--no-confirm`
68
69	### 2. Category Management
70
71	#### List All Categories
72	```bash
73	ktui category list --json
74	```
75	Output: Array of categories with `category_id`, `name`, `color`
76
77	#### Create Category
78	```bash
79	ktui category create "Category Name" "color"
80	```
81	Options:
82	- `color`: Optional. If omitted, a color is automatically assigned.
83	Note: Color must be a valid CSS/X11 color name or hex code (e.g., "red", "#FF0000").
84
85	#### Update Category
86	```bash
87	ktui category update CATEGORY_ID --name "New Name" --color "new-color"
88	```
89	Note: Only specified fields are updated; others remain unchanged
90
91	#### Delete Category
92	```bash
93	ktui category delete CATEGORY_ID --no-confirm
94	```
95	Impact: Resets the category of all associated tasks to null, as an agent always use `--no-confirm`
96
97	### 3. Task Management
98
99	#### List Tasks
100	```bash
101	ktui task list --json
102	```
103	Filters:
104	- `--column COLUMN_ID`: Tasks in specific column
105	- `--board BOARD_ID`: Tasks on specific board
106	- `--actionable`: Only non-blocked tasks (no unfinished dependencies)
107
108	Output Fields: `task_id`, `title`, `description`, `column_id`, `board_id`, `due_date`, `category_id`, `depends_on` (array), `creation_date`
109
110	#### Create Task
111	```bash
112	ktui task create "Task Title" --description "Details" --column COLUMN_ID --category CATEGORY_ID --due-date 2026-01-20 --depends-on TASK_ID
113	```
114	Options:
115	- `--column`: Target column ID (omit for leftmost visible column of active board)
116	- `--category`: Category ID to assign to the task
117	- `--due-date`: Format MUST be `YYYY-MM-DD` (e.g., "2026-01-20")
118	- `--depends-on`: Dependency task ID (use multiple times for multiple dependencies)
119
120	Example Multi-Dependency:
121	```bash
122	ktui task create "Deploy to prod" --depends-on 5 --depends-on 7 --depends-on 9
123	```
124
125	Note: To create tasks on other boards, only use the `--colu

People who liked this also viewed

6 picks

Type