{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/vikunja-kanban",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vikunja-kanban",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/vikunja-add-task.sh",
      "scripts/vikunja-complete-task.sh",
      "scripts/vikunja-move-task.sh",
      "scripts/vikunja-status.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/vikunja-kanban",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Vikunja Kanban Skill",
        "body": "Manage a Vikunja kanban board via API. Read status, create/move/complete tasks, and integrate with heartbeat and triage crons."
      },
      {
        "title": "Config",
        "body": "Credentials stored in secrets/vikunja.env:\n\nVIKUNJA_URL=https://your-vikunja-instance\nVIKUNJA_TOKEN=${VIKUNJA_TOKEN}\nVIKUNJA_PROJECT_ID=1\nVIKUNJA_VIEW_ID=4"
      },
      {
        "title": "Authentication",
        "body": "All scripts use a long-lived API token (expires 2030-01-01). No JWT login needed.\n\nPermissions: tasks (read_all, update, create, delete), projects (read_all, update, create)\nJWT login credentials kept in secrets/vikunja.env for reference only"
      },
      {
        "title": "Bucket IDs",
        "body": "IDNamePurpose1🔴 UrgentNeeds immediate attention2⏳ Waiting OnSent/requested, awaiting reply7⚠️ System IssuesInfra/system problems8🚧 Active ProjectsIn progress9📅 UpcomingScheduled/future10📥 InboxNew items, untriaged3✅ DoneCompleted"
      },
      {
        "title": "Scripts",
        "body": "All scripts are in the skill's scripts/ directory. Run from the skill root."
      },
      {
        "title": "Read the board",
        "body": "bash scripts/vikunja-status.sh              # All buckets\nbash scripts/vikunja-status.sh \"Urgent\"     # Filter by bucket name"
      },
      {
        "title": "Add a task",
        "body": "bash scripts/vikunja-add-task.sh \"Title\" \"Description\" BUCKET_ID [PRIORITY]\n# Priority: 0=unset, 1=low, 2=medium, 3=high, 4=urgent\n# Example: bash scripts/vikunja-add-task.sh \"Fix DNS\" \"Check records\" 1 4"
      },
      {
        "title": "Move a task between buckets",
        "body": "bash scripts/vikunja-move-task.sh TASK_ID BUCKET_ID\n# Example: bash scripts/vikunja-move-task.sh 15 3  # Move to Done"
      },
      {
        "title": "Complete a task",
        "body": "bash scripts/vikunja-complete-task.sh TASK_ID"
      },
      {
        "title": "Heartbeat Integration",
        "body": "The heartbeat cron reads from Vikunja:\n\nbash scripts/vikunja-status.sh\n\nCheck 🔴 Urgent for items aging >1h\nIf Vikunja unreachable, fall back to scripts/nc-status-board.sh read"
      },
      {
        "title": "Email Triage Integration",
        "body": "Email triage adds Action Required items to the Inbox bucket:\n\nbash scripts/vikunja-add-task.sh \"Email subject\" \"Brief description\" 10 3"
      },
      {
        "title": "API Reference",
        "body": "Base URL: https://your-vikunja-instance/api/v1\nAuth: POST /login with username/password → JWT token (short-lived)\nTasks: PUT /projects/{id}/tasks (create), POST /tasks/{id} (update)\nBuckets: POST /projects/{id}/views/{view}/buckets/{bucket}/tasks (move task)\nViews: GET /projects/{id}/views/{view}/tasks (list tasks by bucket)\nProjects: POST /projects/{id} (update title/settings), GET /projects (list all)\nSharing: PUT /projects/{id}/users {\"username\":\"...\", \"right\":N} (add user)\nUsers: GET /users?s=query (search), POST /user/password (self-service password change)"
      },
      {
        "title": "Sharing permissions ignored on creation",
        "body": "PUT /projects/{id}/users ignores the right field — always creates with permission=0 (read-only).\nWorkaround: Set permission directly in PostgreSQL:\n\nUPDATE users_projects SET permission = 2 WHERE user_id = X AND project_id = Y;\n\nPermission values: 0=read-only, 1=read+write, 2=admin"
      },
      {
        "title": "Default Inbox project cannot be deleted",
        "body": "Every new user gets an auto-created \"Inbox\" project. DELETE /projects/{id} returns error 3012.\nWorkaround: Rename it: POST /projects/{id} with {\"title\":\"New Name\"}"
      },
      {
        "title": "Password change is self-service only",
        "body": "No admin endpoint to change another user's password. Must login as the target user:\nPOST /api/v1/user/password with {\"old_password\":\"...\", \"new_password\":\"...\"}"
      },
      {
        "title": "API token creation needs both tasks AND projects permissions",
        "body": "Tokens with only tasks permissions cannot read kanban views (returns 401).\nMust include: \"permissions\":{\"tasks\":[\"read_all\",\"update\",\"create\",\"delete\"],\"projects\":[\"read_all\",\"update\",\"create\"]}"
      },
      {
        "title": "Token creation endpoint",
        "body": "PUT /api/v1/tokens to create, GET /api/v1/tokens to list, DELETE /api/v1/tokens/{id} to remove.\nRequired fields: title, expires_at (ISO-8601), permissions (object with permission groups)."
      },
      {
        "title": "Notes",
        "body": "Long-lived API token used (expires 2030) — no JWT login overhead\nVikunja uses PUT for creation, POST for updates (unusual)\nBucket IDs are specific to the Kanban view (view_id=4)\nProject name: \"Kit Operations\" (renamed from default \"Inbox\")\nProject shared: Kit (id:1, admin/owner), Alex (id:2, admin via DB fix)\nToken has tasks + projects permissions; covers all kanban operations\nEach user gets a default project that can't be deleted — rename to avoid confusion"
      }
    ],
    "body": "Vikunja Kanban Skill\n\nManage a Vikunja kanban board via API. Read status, create/move/complete tasks, and integrate with heartbeat and triage crons.\n\nConfig\n\nCredentials stored in secrets/vikunja.env:\n\nVIKUNJA_URL=https://your-vikunja-instance\nVIKUNJA_TOKEN=${VIKUNJA_TOKEN}\nVIKUNJA_PROJECT_ID=1\nVIKUNJA_VIEW_ID=4\n\nAuthentication\n\nAll scripts use a long-lived API token (expires 2030-01-01). No JWT login needed.\n\nPermissions: tasks (read_all, update, create, delete), projects (read_all, update, create)\nJWT login credentials kept in secrets/vikunja.env for reference only\nBucket IDs\nID\tName\tPurpose\n1\t🔴 Urgent\tNeeds immediate attention\n2\t⏳ Waiting On\tSent/requested, awaiting reply\n7\t⚠️ System Issues\tInfra/system problems\n8\t🚧 Active Projects\tIn progress\n9\t📅 Upcoming\tScheduled/future\n10\t📥 Inbox\tNew items, untriaged\n3\t✅ Done\tCompleted\nScripts\n\nAll scripts are in the skill's scripts/ directory. Run from the skill root.\n\nRead the board\nbash scripts/vikunja-status.sh              # All buckets\nbash scripts/vikunja-status.sh \"Urgent\"     # Filter by bucket name\n\nAdd a task\nbash scripts/vikunja-add-task.sh \"Title\" \"Description\" BUCKET_ID [PRIORITY]\n# Priority: 0=unset, 1=low, 2=medium, 3=high, 4=urgent\n# Example: bash scripts/vikunja-add-task.sh \"Fix DNS\" \"Check records\" 1 4\n\nMove a task between buckets\nbash scripts/vikunja-move-task.sh TASK_ID BUCKET_ID\n# Example: bash scripts/vikunja-move-task.sh 15 3  # Move to Done\n\nComplete a task\nbash scripts/vikunja-complete-task.sh TASK_ID\n\nHeartbeat Integration\n\nThe heartbeat cron reads from Vikunja:\n\nbash scripts/vikunja-status.sh\n\nCheck 🔴 Urgent for items aging >1h\nIf Vikunja unreachable, fall back to scripts/nc-status-board.sh read\nEmail Triage Integration\n\nEmail triage adds Action Required items to the Inbox bucket:\n\nbash scripts/vikunja-add-task.sh \"Email subject\" \"Brief description\" 10 3\n\nAPI Reference\nBase URL: https://your-vikunja-instance/api/v1\nAuth: POST /login with username/password → JWT token (short-lived)\nTasks: PUT /projects/{id}/tasks (create), POST /tasks/{id} (update)\nBuckets: POST /projects/{id}/views/{view}/buckets/{bucket}/tasks (move task)\nViews: GET /projects/{id}/views/{view}/tasks (list tasks by bucket)\nProjects: POST /projects/{id} (update title/settings), GET /projects (list all)\nSharing: PUT /projects/{id}/users {\"username\":\"...\", \"right\":N} (add user)\nUsers: GET /users?s=query (search), POST /user/password (self-service password change)\nKnown API Bugs & Gotchas\nSharing permissions ignored on creation\n\nPUT /projects/{id}/users ignores the right field — always creates with permission=0 (read-only). Workaround: Set permission directly in PostgreSQL:\n\nUPDATE users_projects SET permission = 2 WHERE user_id = X AND project_id = Y;\n\n\nPermission values: 0=read-only, 1=read+write, 2=admin\n\nDefault Inbox project cannot be deleted\n\nEvery new user gets an auto-created \"Inbox\" project. DELETE /projects/{id} returns error 3012. Workaround: Rename it: POST /projects/{id} with {\"title\":\"New Name\"}\n\nPassword change is self-service only\n\nNo admin endpoint to change another user's password. Must login as the target user: POST /api/v1/user/password with {\"old_password\":\"...\", \"new_password\":\"...\"}\n\nAPI token creation needs both tasks AND projects permissions\n\nTokens with only tasks permissions cannot read kanban views (returns 401). Must include: \"permissions\":{\"tasks\":[\"read_all\",\"update\",\"create\",\"delete\"],\"projects\":[\"read_all\",\"update\",\"create\"]}\n\nToken creation endpoint\n\nPUT /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).\n\nNotes\nLong-lived API token used (expires 2030) — no JWT login overhead\nVikunja uses PUT for creation, POST for updates (unusual)\nBucket IDs are specific to the Kanban view (view_id=4)\nProject name: \"Kit Operations\" (renamed from default \"Inbox\")\nProject shared: Kit (id:1, admin/owner), Alex (id:2, admin via DB fix)\nToken has tasks + projects permissions; covers all kanban operations\nEach user gets a default project that can't be deleted — rename to avoid confusion"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/shad0wca7/vikunja-kanban",
    "publisherUrl": "https://clawhub.ai/shad0wca7/vikunja-kanban",
    "owner": "shad0wca7",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}