Agent skill

Kanban Init

by cyanluna-git in cyanluna-git/cyanluna.skills

Initialize the current project in local SQLite kanban. An agent skill from cyanluna-git/cyanluna.skills.

MITAuto-check passedProductivity & Automation

Install Kanban Init

skills CLI
$ npx skills add cyanluna-git/cyanluna.skills --skill kanban-init -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cyanluna-git/cyanluna.skills kanban-init --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cyanluna-git/cyanluna.skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/kanban-init .claude/skills/kanban-init && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kanban-init
GitHub stars
183
Token cost
~1.3k tokens
SKILL.md length
254 words
Files
11
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Initialize the current project in local SQLite kanban. An agent skill from cyanluna-git/cyanluna.skills.

  • Works in 5 steps: Determine project name → Write local project config → Create SQLite database → …
  • Tasks that involve Task management
  • SKILL.md covers Usage, Procedure and Notes
  • Runs TypeScript scripts from its folder; calls sqlite3, git and apt

What it does

Kanban Init is an agent skill from cyanluna-git/cyanluna.skills. Initialize the current project in local SQLite kanban. Creates ~/.claude/kanban-dbs/{project}.db and writes local config. Usage: /kanban-init or /kanban-init my-project-name. Run with /kanban-init.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files (for example `onedrive-setup.md`, `templates/package.json` and `templates/plugins/kanban-api.ts`).

It sits in Productivity & Automation, covering Task management. It works with SQLite and PostgreSQL. The licence is MIT.

When your agent uses it

  • Tasks that involve Task management

Example prompts

  • “/kanban-init”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Determine project name
  2. Write local project config
  3. Create SQLite database
  4. Register project metadata (best-effort)
  5. Output confirmation

What it can do on your machine

Read from SKILL.md and the folder at commit df5be37. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • sqlite3
    • git
    • apt
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kanban Init loads about 1.3k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 254 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cyanluna-git/cyanluna.skills at commit df5be37, republished under its MIT licence (© cyanluna-git). 254 words, ~1,331 tokens.

Download SKILL.mdSave it as .claude/skills/kanban-init/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
kanban-init
description
Initialize the current project in local SQLite kanban. Creates ~/.claude/kanban-dbs/{project}.db and writes local config. Usage: /kanban-init or /kanban-init my-project-name. Run with /kanban-init.
license
MIT

Initializes the current project with a local SQLite kanban database at ~/.claude/kanban-dbs/{project}.db. No server, no auth, no internet required — everything runs locally.

Usage

/kanban-init                           — project name = basename of current directory
/kanban-init my-project-name           — explicit project name

Strip any leading dashes from the project token: /kanban-init -unahouse.finance → project unahouse.finance.

Procedure

1. Determine project name
bash
ARG="${1:-}"
PROJECT=$(printf '%s' "$ARG" | sed 's/^-*//' | sed 's/\.db$//')
if [ -z "$PROJECT" ]; then
  PROJECT=$(basename "$(pwd)" | sed 's/\.db$//')
fi
DB="$HOME/.claude/kanban-dbs/${PROJECT}.db"

Always strip .db suffix — old configs stored the DB filename as the project name (e.g. cpet.db).

2. Write local project config

Create in the current project root:

  • .claude/kanban.json
  • .codex/kanban.json (for Codex compatibility)
json
{
  "project": "<PROJECT_NAME>"
}

Use the Write tool to create both files with the same content.

3. Create SQLite database
bash
mkdir -p "$HOME/.claude/kanban-dbs"
sqlite3 "$DB" << 'SQL'
CREATE TABLE IF NOT EXISTS tasks (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  project TEXT NOT NULL,
  title TEXT NOT NULL,
  status TEXT NOT NULL DEFAULT 'todo',
  priority TEXT NOT NULL DEFAULT 'medium',
  description TEXT,
  plan TEXT,
  implementation_notes TEXT,
  tags TEXT DEFAULT '[]',
  review_comments TEXT DEFAULT '[]',
  plan_review_comments TEXT DEFAULT '[]',
  test_results TEXT DEFAULT '[]',
  agent_log TEXT DEFAULT '[]',
  notes TEXT DEFAULT '[]',
  current_agent TEXT,
  plan_review_count INTEGER NOT NULL DEFAULT 0,
  impl_review_count INTEGER NOT NULL DEFAULT 0,
  level INTEGER NOT NULL DEFAULT 3,
  attachments TEXT DEFAULT '[]',
  decision_log TEXT,
  done_when TEXT,
  rank INTEGER NOT NULL DEFAULT 0,
  created_at TEXT DEFAULT (datetime('now')),
  updated_at TEXT DEFAULT (datetime('now')),
  started_at TEXT,
  planned_at TEXT,
  reviewed_at TEXT,
  tested_at TEXT,
  completed_at TEXT
);

CREATE TABLE IF NOT EXISTS projects (
  id TEXT PRIMARY KEY,
  name TEXT,
  purpose TEXT,
  stack TEXT,
  brief TEXT,
  status TEXT DEFAULT 'active',
  category TEXT,
  repo_url TEXT,
  created_at TEXT DEFAULT (datetime('now'))
);

CREATE TABLE IF NOT EXISTS project_links (
  source_id TEXT NOT NULL,
  target_id TEXT NOT NULL,
  relation TEXT NOT NULL,
  PRIMARY KEY (source_id, target_id, relation)
);
SQL

If the DB already exists (table already created), CREATE TABLE IF NOT EXISTS is idempotent — safe to run again.

4. Register project metadata (best-effort)
bash
# Infer category from path
PARENT_DIR=$(basename "$(dirname "$(pwd)")")
if [ "$PARENT_DIR" = "edwards" ]; then
  CATEGORY="edwards"
elif echo "$PROJECT" | grep -qE 'skills|kanban'; then
  CATEGORY="skills"
elif echo "$PROJECT" | grep -qE 'tools|assist|gmail|jira'; then
  CATEGORY="tools"
elif [ "$PROJECT" = "community.skills" ]; then
  CATEGORY="community"
else
  CATEGORY="personal"
fi

# Infer purpose from CLAUDE.md
PURPOSE=$(grep -v '^#' CLAUDE.md 2>/dev/null | grep -v '^---' | grep -v '^\s*$' | head -1 | cut -c1-300 || echo "")

# Infer repo_url from git remote
REPO_URL=$(git remote get-url origin 2>/dev/null || echo "")

Then upsert into projects table:

bash
sqlite3 "$DB" "INSERT OR REPLACE INTO projects (id, name, category, repo_url) VALUES ('$PROJECT', '$PROJECT', '$CATEGORY', '$REPO_URL')"

If PURPOSE is set:

bash
sqlite3 "$DB" "UPDATE projects SET purpose='$PURPOSE' WHERE id='$PROJECT'"

This is best-effort — if it fails (e.g., sqlite3 not found), init still continues.

5. Output confirmation
✅ Project '<PROJECT_NAME>' initialized.

  Config:  .claude/kanban.json, .codex/kanban.json
  DB:      ~/.claude/kanban-dbs/<PROJECT_NAME>.db
  Tables:  tasks, projects, project_links

Add tasks with /kanban add <title>

Notes

Existing config detection

If either .claude/kanban.json or .codex/kanban.json already exists:

  1. Read the project field and strip .db suffix (old format stored DB filename as project name)
  2. If the cleaned name differs from what's stored, show the migration clearly
  3. Ask the user whether to overwrite or keep as-is:
.claude/kanban.json already exists:
  Current project: "cpet.db"  →  will use "cpet" (stripped .db suffix)

Options:
1. Overwrite — update config
2. Keep as-is — leave existing config unchanged
Migrating from PostgreSQL kanban

If the user had a PostgreSQL-based kanban (prior kanban-auth setup):

  • The old ~/.claude/kanban-auth file is no longer needed for the SQLite version
  • Data migration from PostgreSQL → SQLite is not automated; start fresh or export manually
  • Tasks in the old PostgreSQL DB are not accessible from the SQLite version
sqlite3 requirement

The sqlite3 CLI must be installed on the system:

bash
# Debian/Ubuntu
apt install sqlite3

# macOS (usually pre-installed)
brew install sqlite

Verify: sqlite3 --version

© cyanluna-git, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files in kanban-init of cyanluna-git/cyanluna.skills.

  • SKILL.md
  • onedrive-setup.md
  • templates/.env.example
  • templates/.gitignore
  • templates/index.html
  • templates/package.json
  • templates/plugins/kanban-api.ts
  • templates/src/main.ts
  • templates/src/style.css
  • templates/tsconfig.json
  • templates/vite.config.ts

Open the folder on GitHubat commit df5be37

Compare with similar skills

Kanban Init next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kanban Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kanban Init this skillcyanluna-git/cyanluna.skills183—~1.3kAutomated safety check: PassMIT
No Nonsense Taskssundial-org/awesome-openclaw-skills663—~835Automated safety check: PassNone
TaskflowLeoYeAI/openclaw-master-skills2.2k—~6.5kAutomated safety check: PassMIT
Retinuejklthinking/retinue112—~279Automated safety check: PassMIT
Task Backlog Managermp-web3/claude-starter-kit109—~1.2kAutomated safety check: NotesMIT
SQL Database Support for pRESTprest/prest4.6k—~1.6kAutomated safety check: PassMIT

Similar skills

  • No Nonsense Tasks

    sundial-org/awesome-openclaw-skills

    No-nonsense task manager using SQLite. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~835 tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check passed
  • Taskflow

    LeoYeAI/openclaw-master-skills

    Structured project/task management for OpenClaw agents — markdown-first authoring, SQLite-backed querying, bidirectional sync, CLI, Apple Notes integration.

    2.2k GitHub stars~6.5k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Retinue

    jklthinking/retinue

    Coordinate work through a local Retinue workspace using its MCP tools.

    112 GitHub stars~279 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Task Backlog Manager

    mp-web3/claude-starter-kit

    Keeps a personal task backlog in SQLite behind a /tasks command that adds, reviews, completes and measures tasks against a list of long-term problems.

    109 GitHub stars~1.2k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes
  • Guides classifying, gap-analyzing and scaffolding support for a new SQL database in pREST, from Postgres-compatible variants to entirely new dialects.

    4.6k GitHub stars~1.6k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Migration

    gocronx-team/gocron

    Create, review, or verify gocron database migrations across SQLite, MySQL, and PostgreSQL.

    808 GitHub stars~1.1k tokensUpdated 6 days ago
    DatabasesAuto-check passed

More from cyanluna-git/cyanluna.skills

All 16 skills in this repo
  • Kanban Batch Run

    cyanluna-git/cyanluna.skills

    Run multiple kanban tasks end-to-end in Rolling Wave order — refine each task based on the prior card's actual implementation, then implement, then verify, then refine the next.

    183 GitHub stars~2.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Kanban

    cyanluna-git/cyanluna.skills

    Manage project tasks in a local SQLite DB (~/.claude/kanban-dbs/{project}.db).

    183 GitHub stars~3.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Kanban Explore

    cyanluna-git/cyanluna.skills

    Codebase exploration skill for uncertain implementation direction.

    183 GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Kanban Local

    cyanluna-git/cyanluna.skills

    Local markdown-file kanban for toy and personal projects. An agent skill from cyanluna-git/cyanluna.skills.

    183 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Kanban Run

    cyanluna-git/cyanluna.skills

    Run the AI team pipeline for kanban tasks — orchestration loop with 6 agents (Planner, Critic, Builder, Shield, Inspector, Ranger), single-step execution, and code review.

    183 GitHub stars~4.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Kanban Spec

    cyanluna-git/cyanluna.skills

    Turn vague intent into a precise, executable spec through 5 structured phases, then optionally create a kanban task.

    183 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Kanban Init

What does Kanban Init do?

Initialize the current project in local SQLite kanban. An agent skill from cyanluna-git/cyanluna.skills. skills. Initialize the current project in local SQLite kanban.

When should I use Kanban Init?

Kanban Init fits situations like: tasks that involve Task management.

How do I install Kanban Init in Claude Code?

Run `npx skills add cyanluna-git/cyanluna.skills --skill kanban-init -a claude-code`. Or copy the skill folder (kanban-init in cyanluna-git/cyanluna.skills) into .claude/skills/kanban-init in your project. Claude Code loads it when a task matches its description.

How do I install Kanban Init in Codex?

Run `npx skills add cyanluna-git/cyanluna.skills --skill kanban-init -a codex`. Or copy the skill folder (kanban-init in cyanluna-git/cyanluna.skills) into .agents/skills/kanban-init in your project. Codex loads it when a task matches its description.

Can I use Kanban Init in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cyanluna-git/cyanluna.skills --skill kanban-init -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kanban-init, .gemini/skills/kanban-init, .github/skills/kanban-init and .opencode/skills/kanban-init in your project.

What does Kanban Init need to run?

Going by SKILL.md and its folder, Kanban Init needs TypeScript for the scripts in its folder and the command-line tools its instructions call (sqlite3, git, apt and brew). Our summary lists: Node.js.

Does Kanban Init access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Kanban Init safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kanban Init use?

Kanban Init is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kanban Init use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kanban Init?

Skills that share tags, products or a category with Kanban Init: No Nonsense Tasks (sundial-org/awesome-openclaw-skills, 663 stars), Taskflow (LeoYeAI/openclaw-master-skills, 2.2k stars), Retinue (jklthinking/retinue, 112 stars) and Task Backlog Manager (mp-web3/claude-starter-kit, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kanban Init?

cyanluna-git (a GitHub user) maintains it in cyanluna-git/cyanluna.skills, which has 183 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on June 22, 2026.

Source: cyanluna-git/cyanluna.skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.