Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Add API bugs/gotchas docs, user management notes, project sharing workarounds
What This Skill Does
Manages a Vikunja kanban board through bash scripts and the Vikunja REST API. Supports reading board state, creating tasks, moving tasks between buckets, and marking tasks complete. Integrates with heartbeat monitoring and email triage workflows.
Uses a long-lived API token so other crons can call the scripts directly without handling JWT refresh or re-authentication.
When to use it
- Adding an incoming email action item to the Inbox bucket
- Moving a task from Active Projects to Done after finishing work
- Checking urgent tasks aging over an hour during a heartbeat run
- Creating a high-priority infra task in the System Issues bucket
- Filtering the board to see only tasks in a specific bucket
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: add a task to fix DNS records, high priority, urgent bucket
- 1Identify target bucket ID (1 = Urgent)
- 2Run vikunja-add-task.sh with title 'Fix DNS', description 'Check records', bucket 1, priority 4
- 3API returns the created task ID
- 4Confirm task appears in the Urgent bucket by running vikunja-status.sh with filter 'Urgent'
Task 'Fix DNS' created in the Urgent bucket with priority 4
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.