Name: vikunja
Author: zrong

Imported from zrong/skills (vikunja/SKILL.md). Install upstream with npx skills add zrong/skills --skill vikunja. Copyright stays with the author.

Vikunja Skill

从自托管 Vikunja 实例读取任务，同步到 Joplin。

前置依赖

joplin skill 必须已安装（https://github.com/zrong/skills）
Vikunja 实例需要可访问
在 agent_config.toml 中配置 [vikunja] section

环境配置

在 agent_config.toml 中添加：

[vikunja]
base_url = "https://nas.zengrong.net:8456/api/v1"
api_token = "<your-api-token>"

命令指南

建议使用 uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py <command> 执行。

1. 项目

列出项目: list-projects

2. 任务

列出任务: list-tasks [--project ID] [--done] [--week YYYY-Www] [--limit N]
- 使用 --week 时，任务归属周按有效日期判断：若任务设置了 end_date，优先使用 end_date；否则使用 done_at

3. 同步

同步到 Joplin: sync-weekly [--note "2026-03-14weeks"] [--week "2026-W14"]
- 无参数：同步当前周
- --note：从笔记标题解析目标周
- --week：直接指定 ISO 周
- 写入 daily 小节时按任务有效日期分组：优先 end_date，未设置时使用 done_at

测试流程

uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-projects
uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-tasks --done --limit 5
uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py sync-weekly

Install vikunja and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "zrong-skills-vikunja", "kind": "skill", "name": "vikunja", "description": "Vikunja 任务管理工具，支持查看项目和任务，并将每周已完成的任务同步到 Joplin weekly 笔记。", "publisher": "zrong", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Vikunja 任务管理工具，支持查看项目和任务，并将每周已完成的任务同步到 Joplin weekly 笔记。" ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/zrong/skills", "path": "vikunja/SKILL.md", "ref": "HEAD", "url": "https://github.com/zrong/skills/blob/HEAD/vikunja/SKILL.md", "key": "zrong/skills/vikunja/SKILL.md" } }, "instructions": "# Vikunja Skill\n\n从自托管 Vikunja 实例读取任务，同步到 Joplin。\n\n## 前置依赖\n\n- **joplin skill** 必须已安装（`https://github.com/zrong/skills`）\n- Vikunja 实例需要可访问\n- 在 `agent_config.toml` 中配置 `[vikunja]` section\n\n## 环境配置\n\n在 `agent_config.toml` 中添加：\n\n```toml\n[vikunja]\nbase_url = \"https://nas.zengrong.net:8456/api/v1\"\napi_token = \"<your-api-token>\"\n```\n\n## 命令指南\n\n建议使用 `uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py <command>` 执行。\n\n### 1. 项目\n\n- **列出项目**: `list-projects`\n\n### 2. 任务\n\n- **列出任务**: `list-tasks [--project ID] [--done] [--week YYYY-Www] [--limit N]`\n - 使用 `--week` 时，任务归属周按有效日期判断：若任务设置了 `end_date", "cost": { "context_tokens": 279 } }

vikunja

About

Vikunja Skill

前置依赖

环境配置

命令指南

1. 项目

2. 任务

3. 同步

测试流程

Use it

Install vikunja and it becomes one more candidate the router can pick - when it fits.

Manifest

Reviews