← Back to Skills Marketplace
Vikunja-complete
by
KohlHammond
· GitHub ↗
· v4.0.0
· MIT-0
352
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install vikunja-complete
Description
Production-oriented Vikunja task/project management skill with deterministic commands and strong validation.
Usage Guidance
This package appears to do what it says: a deterministic CLI for Vikunja that will call the Vikunja API. Before enabling it: (1) only provide a VIKUNJA_TOKEN with the minimum permissions needed (consider creating a scoped/test token); (2) run the included smoke test against a non-production Vikunja instance if you want to validate behavior (the smoke test creates projects/tasks/labels/tokens); (3) review the vikunja.sh script yourself (it is included) to confirm no unexpected network endpoints or persistence are added; and (4) because the skill author is not a known publisher in the metadata, prefer using it in a sandbox or with limited credentials until you are comfortable.
Capability Analysis
Type: OpenClaw Skill
Name: vikunja-complete
Version: 4.0.0
The skill bundle provides a highly capable CLI for Vikunja management that includes several high-risk features such as API token creation, webhook management, and arbitrary file uploads/downloads (vikunja.sh). While the main script follows security best practices by using jq for JSON construction, the test-smoke.sh script contains a JSON injection vulnerability in the ensure_project function where the project title is interpolated directly into a JSON string. These powerful capabilities, combined with the lack of path restrictions on file operations, create a significant attack surface for data exfiltration or persistence if the AI agent is manipulated via prompt injection.
Capability Assessment
Purpose & Capability
Name/description match behavior: the skill implements a CLI wrapper (vikunja.sh) that talks to the Vikunja API. Required binaries (curl, jq) and required env vars (VIKUNJA_URL, VIKUNJA_TOKEN) are consistent with that purpose.
Instruction Scope
SKILL.md and the included scripts constrain operations to the Vikunja API (tasks, comments, labels, attachments, webhooks, tokens, etc.). The optional smoke test will create/modify resources (projects, tasks, labels, tokens) on the target Vikunja instance — this is expected for an integration but is state-modifying, so run against a test instance or with a limited-scope token if you want to avoid side effects.
Install Mechanism
No external install/download spec is present; the package is instruction+script-based. There are no remote URLs being downloaded or extracted during install, which lowers supply-chain risk.
Credentials
Only VIKUNJA_URL and VIKUNJA_TOKEN (plus optional retry env vars) are required. These are appropriate and proportionate for an API client. Note: VIKUNJA_TOKEN is sensitive and grants access to the target instance.
Persistence & Privilege
Skill is not marked always:true and does not request elevated platform persistence. It does not modify other skills or system-wide configs; autonomous invocation is allowed at the platform default level (not an additional concern here).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vikunja-complete - After installation, invoke the skill by name or use
/vikunja-complete - Provide required inputs per the skill's parameter spec and get structured output
Version History
v4.0.0
- Major rewrite: Custom Vikunja skill with production-grade command scripts and strong validation.
- Adds comprehensive task, comment, label, assignee, view, webhook, attachment, relation, filter, notification, subscription, and API token management via deterministic shell commands.
- Robust setup instructions included, requiring curl, jq, and environment variables.
- Includes smoke test harness for end-to-end validation.
Metadata
Frequently Asked Questions
What is Vikunja-complete?
Production-oriented Vikunja task/project management skill with deterministic commands and strong validation. It is an AI Agent Skill for Claude Code / OpenClaw, with 352 downloads so far.
How do I install Vikunja-complete?
Run "/install vikunja-complete" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Vikunja-complete free?
Yes, Vikunja-complete is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Vikunja-complete support?
Vikunja-complete is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Vikunja-complete?
It is built and maintained by KohlHammond (@kohlhammond); the current version is v4.0.0.
More Skills