kanban-init

Register a project in a PostgreSQL-based Kanban system and create local config files.

173|42|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/cyanluna-git/cyanluna.skills --skill kanban-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kanban-init
Source: https://github.com/cyanluna-git/cyanluna.skills/tree/main/kanban-init
Command: npx skills add https://github.com/cyanluna-git/cyanluna.skills --skill kanban-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Registers a new project in a shared PostgreSQL Kanban instance, automating local config creation so the board can route tasks to the correct project.

Core Features & Use Cases

  • Auto-detects project name from the current directory when not explicitly provided.
  • Creates per-project config files (.claude/kanban.json and .codex/kanban.json) and ensures consistent board association.
  • Upserts project metadata to a central projects table (best-effort; operates gracefully when the API is unavailable).

Quick Start

Run /kanban-init in your project root to register the project name and initialize its board settings in the central DB.

Frequently Asked Questions about kanban-init

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

FAQPage Schema
How do I register a new project in a PostgreSQL Kanban system?

To register a new project in the PostgreSQL Kanban system, run the initialization command in your project root to derive the project name and write local configuration files.

How do I automatically create Kanban configuration files for my project?

You can automatically create Kanban configuration files (.claude/kanban.json and .codex/kanban.json) by running the initialization command, which derives the project name from the current directory.

Can I explicitly specify a project name when initializing Kanban board settings?

Yes, you can explicitly specify a project name as an argument during initialization; otherwise, the system automatically derives the project name from your current directory path.

What happens if the central PostgreSQL Kanban API is unavailable during project registration?

If the central PostgreSQL Kanban API is unavailable, the initialization process degrades gracefully and operates on a best-effort basis, ensuring local configuration files are still written successfully.

Does Kanban initialization support custom base board URLs for routing tasks?

Yes, the Kanban initialization process supports optional base board URLs, validating and normalizing the input to ensure consistent board association for routing tasks to the correct project.

Why do I need per-project Kanban configuration files?

Per-project Kanban configuration files are needed to ensure consistent board association, allowing the central PostgreSQL Kanban system to accurately route tasks to the correct project.