vikunja

What This Skill Does

The Vikunja skill enables OpenClaw AI agents to interact directly with a self-hosted Vikunja instance, bringing enterprise-grade project management directly into your conversational workflow. By leveraging the Vikunja API, the agent can organize work, track progress, and manage task lifecycles without requiring the user to switch context to a web browser. Users can create hierarchical project structures, generate granular tasks with specific due dates, and assign priority levels ranging from 0 (None) to 5 (Critical). The skill is designed to handle routine project maintenance, such as listing tasks for specific projects or marking items as complete, effectively turning your AI agent into a project coordinator.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/dbhurley/vikunja

Once installed, you must configure the environment variables in your OpenClaw configuration file to grant the agent access to your instance:

• VIKUNJA_URL: The base URL of your Vikunja server.
• VIKUNJA_USER: Your credentials for authentication.
• VIKUNJA_PASSWORD: The corresponding password or token.

Use Cases

This skill is perfect for users who rely on Vikunja for personal or professional organization. Common use cases include:

• Automating the creation of recurring weekly tasks from an agent workflow.
• Providing project status updates during daily stand-ups by querying task lists.
• Aggregating pending high-priority action items across different project boards.
• Rapidly adding "to-do" items identified during brainstorming sessions.

Example Prompts

1. "Create a new project named 'Website Redesign' and add a high-priority task to 'Draft initial landing page content' due next Tuesday."
2. "Show me all pending tasks in the 'Marketing' project and tell me which ones are marked as critical."
3. "I just finished the logo design for the client project; please mark that task as complete in Vikunja."

Tips & Limitations

• JSON Mode: For advanced automation, always append the --json flag to your requests to ensure the output is machine-readable by subsequent agent tools.
• Authentication: Ensure your VIKUNJA_USER has the necessary permissions to create projects and tasks in the desired namespaces.
• Date Formatting: Always provide dates in ISO-8601 format (YYYY-MM-DD) to prevent parsing errors during task creation.
• Limitations: This skill does not currently support advanced features like recurring task patterns, labels, or complex user assignments beyond basic creation, so ensure your workflows align with supported task/project parameters.