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.