← Back to Skills Marketplace
ashanzzz

Vikunja Task Api

by ashanzzz · GitHub ↗ · v2.5.1 · MIT-0
cross-platform ⚠ suspicious
179
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install vikunja-task-api
Description
Install: clawhub install ashanzzz-vikunja-task-api Full Vikunja v2 API integration — projects, tasks, labels, teams, views, comments, attachments, bulk opera...
Usage Guidance
This skill appears to do what it says: interact with your Vikunja instance via its API. Before installing, verify the VIKUNJA_URL points to a trusted instance and prefer using an API token (tk_...) with the least privilege you need. Avoid committing tokens to source control; prefer a restricted, non-world-readable env file or a secrets store instead of plain ~/.bashrc if you care about secrecy. If you plan to run the recommended curl to install the helper script, review the script contents (vikunja.sh) first — the skill bundle already includes it, so you can inspect it locally. Finally, only grant the minimal credentials (token or username/password) necessary and be mindful that adding credentials to shell rc files will persist them on the machine.
Capability Analysis
Type: OpenClaw Skill Name: vikunja-task-api Version: 2.5.1 The skill provides a comprehensive integration with the Vikunja task management API. However, the helper script `vikunja.sh` contains a shell injection vulnerability because it embeds unvalidated command-line arguments (such as task titles or project IDs) directly into double-quoted strings that are subsequently evaluated by the shell during API calls. While this appears to be a functional oversight rather than intentional malware, it allows for arbitrary command execution if the AI agent or a user provides crafted input. The documentation in `SKILL.md` also encourages downloading and executing a script directly from a GitHub repository (ashanzzz/openclaw-person-skills), which is a risky practice.
Capability Assessment
Purpose & Capability
Name/description, required binaries (curl, jq), required env vars (VIKUNJA_URL, VIKUNJA_TOKEN) and the provided CLI script all align with a Vikunja API integration; no unrelated services or credentials are requested.
Instruction Scope
SKILL.md instructs only Vikunja-related actions (API calls, token or username/password auth, storing VIKUNJA_* in environment). It also suggests downloading the helper script to /usr/local/bin and adding tokens to shell rc files — these are normal but worth noting because they persist secrets in plaintext if the user follows them.
Install Mechanism
No automatic install spec is present (instruction-only). The SKILL.md suggests downloading the script from a GitHub raw URL and the repository includes the script itself. Fetching from GitHub raw is standard; nothing indicates an obscure or high-risk download source.
Credentials
Only Vikunja-specific environment variables are required: VIKUNJA_URL and a primary VIKUNJA_TOKEN with optional username/password fallback. The number and type of credentials are proportional to the skill's functionality.
Persistence & Privilege
Skill is not forced-always (always:false) and is user-invocable. It does not request modifications to other skills or system-wide configs beyond optional instructions that the user can follow (e.g., adding env vars to ~/.bashrc).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install vikunja-task-api
  3. After installation, invoke the skill by name or use /vikunja-task-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.5.1
Add Install to description; remove forbidden INSTALL.md; add env var table in body
v2.5.0
- Added AI 自动安装流程,明确分步骤安装 clawhub 和插件(AI 安装命令部分更新) - Bumped version to 2.5.0 - No API or endpoint changes; documentation/installation improvements only
v2.4.0
- Improved installation instructions to clarify AI and human installation flows. - Added explicit guidance that AI reads SKILL.md after install to obtain endpoints and auth info. - Minor clarifications in the usage instructions for both AI and users. - Version bump to 2.4.0.
v2.3.0
- Simplified installation instructions, including a one-line install command for both human users and AI. - Installation and configuration steps now presented in Chinese for easier setup by native speakers. - Clarified post-installation environment variable requirements and verification. - Usage instructions for AI are now streamlined, highlighting direct usage via Chinese instructions without technical API details. - No changes to API endpoints or core functionality.
v2.2.0
- Added installation instructions in both Chinese (for humans) and English (for agents) to SKILL.md. - Clarified required environment variables (VIKUNJA_URL, VIKUNJA_TOKEN) and their setup process. - Bumped skill version to 2.2.0. - No API or functional changes—documentation only.
v2.1.0
Full English rewrite based on official Vikunja v2.2.2 API spec; added all missing endpoints (labels, teams, views, buckets, comments, attachments, relations, bulk ops, filters, reactions, notifications, shares)
v2.0.1
v2.0.1: Fixed SKILL.md name field, minor doc updates
v2.0.0
v2: Vikunja v2 API skill
Metadata
Slug vikunja-task-api
Version 2.5.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 8
Frequently Asked Questions

What is Vikunja Task Api?

Install: clawhub install ashanzzz-vikunja-task-api Full Vikunja v2 API integration — projects, tasks, labels, teams, views, comments, attachments, bulk opera... It is an AI Agent Skill for Claude Code / OpenClaw, with 179 downloads so far.

How do I install Vikunja Task Api?

Run "/install vikunja-task-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Vikunja Task Api free?

Yes, Vikunja Task Api is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Vikunja Task Api support?

Vikunja Task Api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Vikunja Task Api?

It is built and maintained by ashanzzz (@ashanzzz); the current version is v2.5.1.

💬 Comments