planka

What This Skill Does

The Planka skill serves as a powerful command-line interface (CLI) integration for Planka, an open-source, feature-rich Kanban project management platform. This skill empowers OpenClaw agents to manage the entire lifecycle of project tasks. Whether you need to list existing projects, organize workflows by moving cards between columns (lists), or manage card details, this skill provides a structured way to interact with your Planka instance. It simplifies tasks like status checks, creating new cards, and monitoring updates, effectively acting as an automated project manager within your terminal or AI environment.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/voydz/planka

Additionally, you must have the underlying CLI tool installed on your system. You can install it via Homebrew by tapping the vendor repository: brew tap voydz/homebrew-tap && brew install planka-cli

Note: Ensure your Python environment is version 3.11 or higher. Once installed, authenticate your agent by running the login command with your Planka instance URL, username, and password.

Use Cases

This skill is ideal for automating team workflows. For example, it can be used to automatically generate cards based on incident reports, move completed tasks to 'Done' columns, or aggregate notifications to provide daily progress summaries. It is particularly useful for teams that prefer terminal-centric workflows or wish to integrate project management into their CI/CD pipelines.

Example Prompts

1. "Check for any unread notifications in Planka and summarize the recent updates for me."
2. "Create a new card titled 'Deploy staging environment' in the 'To Do' list of my current board."
3. "Move the card with ID 1619901252164912137 to the 'In Progress' list and move it to the top position."

Tips & Limitations

To ensure consistent performance, verify your Planka instance URL and credentials using the planka-cli status command. Be aware that the plankapy dependency requires specific Python versions, so avoid using outdated system interpreters. Large projects with thousands of cards might face slight latency; consider filtering by project ID when listing boards or cards to keep interaction snappy. Finally, remember that authentication is managed locally on your machine, so ensure your environment is secure if you are running this in a shared workspace.