Kan.bn TODO API

Use this skill to run Kan.bn personal task workflows via scripts/kanbn_todo.py.

Keep the interaction goal-oriented: figure out the user's intended task change, discover any missing IDs, execute the smallest correct API operation, then report the result clearly.

Configure authentication

Set auth before running commands:

• - KANBN_TOKEN for bearer auth, or
• INLINECODE2 for API-key auth.

Auth lookup order in kanbn_todo.py:

1. 1. CLI flags (--token, --api-key, --base-url)
2. Process environment (KANBN_TOKEN, KANBN_API_KEY, KANBN_BASE_URL)
3. INLINECODE10 export values (for non-interactive runs)

Optional:

• - KANBN_BASE_URL (defaults to https://kan.bn/api/v1)

If auth is missing, stop early and ask for credentials or confirm the env source.

Follow the standard execution flow

1) Discover context before mutating data

When the user has not provided concrete Kan.bn IDs, resolve them first.

CODEBLOCK0

Use this discovery flow for requests like:

• - "Add a todo in Kan.bn"
• "Move my task to done"
• "Find the board with invoices"

If the user already provided exact card/list/workspace IDs, skip the discovery steps you do not need.

2) Create, then read back

After creating a TODO, read it back when the user cares about confirmation, due date, labels, or returned IDs.

CODEBLOCK1

3) Prefer the narrowest mutation

Choose the command that most directly matches the requested change.

• - Edit title/description/due date -> INLINECODE14
• Change workflow status/list -> INLINECODE15
• Add or remove a label -> INLINECODE16
• Delete the task -> INLINECODE17

Edit fields:

CODEBLOCK2

Change status by moving lists (e.g., TODO -> DOING -> DONE):

CODEBLOCK3

Delete TODO:

CODEBLOCK4

Apply the priority label policy

When a request asks to set, mark, sort, or batch-assign priorities, use labels (P0-P4) as the source of truth.

• - Apply priority via label changes.
• Do not encode priority in titles.
• Keep task titles focused on the actual work item text.
• If the correct priority label ID is unknown, inspect board metadata first.
• Official Kan.bn docs expose label changes on a dedicated endpoint, not todo-update.

For an existing card:

CODEBLOCK5

Use personal productivity workflows

Search tasks in a workspace:

CODEBLOCK6

Add personal notes/comments:

CODEBLOCK7

Track subtasks with checklist:

CODEBLOCK8

Update the personal profile only when the user explicitly asks:

CODEBLOCK9

Handle missing information carefully

When the user asks for an operation but key identifiers are missing:

• - Discover the smallest missing context first
• Prefer search when the user describes a task by text instead of card ID
• Prefer boards when the missing information is board or list structure
• Ask a follow-up question only after exhausting cheap discovery paths

Good examples:

• - User says "mark my invoice task done" -> search for invoice-related cards, identify the likely card, then move it
• User says "add this to my finance board" -> resolve workspace and boards, then ask only if multiple plausible lists remain

Read references only when needed

• - Read references/common-workflows.md for reusable end-to-end task patterns
• Read references/api-scope.md when endpoint details or scope boundaries matter
• Read references/smoke-test.md after changing the script or when validating the skill against a live Kan.bn account

Respect scope

Use only single-user TODO endpoints in this skill.

Do not run collaboration, invite, import, integration, or attachment flows here.