# Send Vikunja Kanban to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "vikunja-kanban", "name": "Vikunja Kanban", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/shad0wca7/vikunja-kanban", "canonicalUrl": "https://clawhub.ai/shad0wca7/vikunja-kanban", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/vikunja-kanban", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vikunja-kanban", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/vikunja-add-task.sh", "scripts/vikunja-complete-task.sh", "scripts/vikunja-move-task.sh", "scripts/vikunja-status.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/vikunja-kanban" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/vikunja-kanban", "downloadUrl": "https://openagent3.xyz/downloads/vikunja-kanban", "agentUrl": "https://openagent3.xyz/skills/vikunja-kanban/agent", "manifestUrl": "https://openagent3.xyz/skills/vikunja-kanban/agent.json", "briefUrl": "https://openagent3.xyz/skills/vikunja-kanban/agent.md" } } ``` ## Documentation ### Vikunja Kanban Skill Manage a Vikunja kanban board via API. Read status, create/move/complete tasks, and integrate with heartbeat and triage crons. ### Config Credentials stored in secrets/vikunja.env: VIKUNJA_URL=https://your-vikunja-instance VIKUNJA_TOKEN=${VIKUNJA_TOKEN} VIKUNJA_PROJECT_ID=1 VIKUNJA_VIEW_ID=4 ### Authentication All scripts use a long-lived API token (expires 2030-01-01). No JWT login needed. Permissions: tasks (read_all, update, create, delete), projects (read_all, update, create) JWT login credentials kept in secrets/vikunja.env for reference only ### Bucket IDs IDNamePurpose1🔴 UrgentNeeds immediate attention2⏳ Waiting OnSent/requested, awaiting reply7⚠️ System IssuesInfra/system problems8🚧 Active ProjectsIn progress9📅 UpcomingScheduled/future10📥 InboxNew items, untriaged3✅ DoneCompleted ### Scripts All scripts are in the skill's scripts/ directory. Run from the skill root. ### Read the board bash scripts/vikunja-status.sh # All buckets bash scripts/vikunja-status.sh "Urgent" # Filter by bucket name ### Add a task bash scripts/vikunja-add-task.sh "Title" "Description" BUCKET_ID [PRIORITY] # Priority: 0=unset, 1=low, 2=medium, 3=high, 4=urgent # Example: bash scripts/vikunja-add-task.sh "Fix DNS" "Check records" 1 4 ### Move a task between buckets bash scripts/vikunja-move-task.sh TASK_ID BUCKET_ID # Example: bash scripts/vikunja-move-task.sh 15 3 # Move to Done ### Complete a task bash scripts/vikunja-complete-task.sh TASK_ID ### Heartbeat Integration The heartbeat cron reads from Vikunja: bash scripts/vikunja-status.sh Check 🔴 Urgent for items aging >1h If Vikunja unreachable, fall back to scripts/nc-status-board.sh read ### Email Triage Integration Email triage adds Action Required items to the Inbox bucket: bash scripts/vikunja-add-task.sh "Email subject" "Brief description" 10 3 ### API Reference Base URL: https://your-vikunja-instance/api/v1 Auth: POST /login with username/password → JWT token (short-lived) Tasks: PUT /projects/{id}/tasks (create), POST /tasks/{id} (update) Buckets: POST /projects/{id}/views/{view}/buckets/{bucket}/tasks (move task) Views: GET /projects/{id}/views/{view}/tasks (list tasks by bucket) Projects: POST /projects/{id} (update title/settings), GET /projects (list all) Sharing: PUT /projects/{id}/users {"username":"...", "right":N} (add user) Users: GET /users?s=query (search), POST /user/password (self-service password change) ### Sharing permissions ignored on creation PUT /projects/{id}/users ignores the right field — always creates with permission=0 (read-only). Workaround: Set permission directly in PostgreSQL: UPDATE users_projects SET permission = 2 WHERE user_id = X AND project_id = Y; Permission values: 0=read-only, 1=read+write, 2=admin ### Default Inbox project cannot be deleted Every new user gets an auto-created "Inbox" project. DELETE /projects/{id} returns error 3012. Workaround: Rename it: POST /projects/{id} with {"title":"New Name"} ### Password change is self-service only No admin endpoint to change another user's password. Must login as the target user: POST /api/v1/user/password with {"old_password":"...", "new_password":"..."} ### API token creation needs both tasks AND projects permissions Tokens with only tasks permissions cannot read kanban views (returns 401). Must include: "permissions":{"tasks":["read_all","update","create","delete"],"projects":["read_all","update","create"]} ### Token creation endpoint PUT /api/v1/tokens to create, GET /api/v1/tokens to list, DELETE /api/v1/tokens/{id} to remove. Required fields: title, expires_at (ISO-8601), permissions (object with permission groups). ### Notes Long-lived API token used (expires 2030) — no JWT login overhead Vikunja uses PUT for creation, POST for updates (unusual) Bucket IDs are specific to the Kanban view (view_id=4) Project name: "Kit Operations" (renamed from default "Inbox") Project shared: Kit (id:1, admin/owner), Alex (id:2, admin via DB fix) Token has tasks + projects permissions; covers all kanban operations Each user gets a default project that can't be deleted — rename to avoid confusion ## Trust - Source: tencent - Verification: Indexed source record - Publisher: shad0wca7 - Version: 1.1.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/vikunja-kanban) - [Send to Agent page](https://openagent3.xyz/skills/vikunja-kanban/agent) - [JSON manifest](https://openagent3.xyz/skills/vikunja-kanban/agent.json) - [Markdown brief](https://openagent3.xyz/skills/vikunja-kanban/agent.md) - [Download page](https://openagent3.xyz/downloads/vikunja-kanban)