← Back to Skills Marketplace
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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vikunja-task-api - After installation, invoke the skill by name or use
/vikunja-task-api - 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
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.
More Skills