A workspace-scoped task management skill for AI agents using the Taskwarrior backend to organize work locally.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install taskwarrior
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install taskwarrior using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Taskwarrior?
The Taskwarrior skill brings professional-grade task management directly into your active coding environment. By leveraging Taskwarrior as a backend, this skill allows AI agents to track, prioritize, and manage project-specific tasks without relying on external cloud services or global configuration files. It is a core component for developers using Openclaw Skills who need to maintain a clear roadmap of their work within a specific repository.
This skill is designed for portability and safety. All task data, metadata, and configuration settings are stored within a hidden directory inside the workspace, ensuring that task lists remain context-aware and isolated from other projects. Whether you are managing complex feature branches or simple todo lists, this integration provides a robust framework for productivity.
Taskwarrior Use Cases
- Managing project-specific todo lists within a Git repository.
- Organizing development milestones with tags, priorities, and due dates.
- Annotating specific tasks with technical notes or implementation details.
- Tracking time and progress on individual sub-tasks during a coding session.
- Automating task updates based on the current state of the codebase through Openclaw Skills.
How Taskwarrior Works
- The skill first verifies the presence of the task binary in the runtime environment by checking the version.
- It resolves the workspace root using environment variables like OPENCLAW_WORKSPACE or falls back to the current working directory.
- A local storage structure is initialized under the .openclaw directory to house the taskrc and data folder, ensuring zero interference with global settings.
- The agent executes standardized Taskwarrior commands while explicitly pointing to the local configuration for every operation.
- Every state-changing operation is followed by a verification check to provide immediate feedback on the task status.
Taskwarrior Setup
Ensure Taskwarrior is installed on your system or within your agent environment. This skill requires the task binary to be available in the path.
# For Debian/Ubuntu systems
sudo apt-get install taskwarrior
# For macOS users via Homebrew
brew install task
The skill automatically handles the creation of the local task environment when first invoked within a workspace supported by Openclaw Skills.
Taskwarrior Data Schema & Taxonomy
The skill organizes data within the workspace to maintain isolation and portability. All data is stored relative to the project root.
| Path | Description |
|---|---|
.openclaw/taskwarrior/taskrc |
The local configuration file defining data paths and behavior defaults. |
.openclaw/taskwarrior/.task/ |
The directory containing the actual Taskwarrior database files. |
Tasks are organized using the following metadata taxonomy:
- Projects: Logical grouping of related tasks for the current workspace.
- Tags: Keywords for easy filtering and categorization.
- Priority: High (H), Medium (M), or Low (L) urgency levels.
- Annotations: Date-stamped notes attached to specific task IDs for historical context.
Taskwarrior Advanced Features
- Workspace isolation ensures task data never leaks into global system configurations or other projects.
- Support for complex filtering using Taskwarrior's powerful query syntax for specific list views.
- Automatic resolution of workspace roots via environment variables commonly used in Openclaw Skills.
- Built-in safety mechanisms to prevent accidental deletion or broad bulk modifications without explicit confirmation.
- Native support for task start/stop cycles and detailed annotations for deep technical tracking.
SKILL.md
Loading
Related Openclaw Skills
ЖКХ Ассистент (Utility Bill Assistant)
An AI-powered assistant designed to decipher complex utility bills, explain every charge in plain language, and identify potential billing errors.
Russian Life Pack: 6 Essential Skills
A comprehensive suite of six AI agents designed to simplify legal, financial, and medical paperwork for users in Russia and the CIS.
AgentWard Sanitize
A security-first PII redaction tool that locally detects and masks sensitive information with zero external dependencies.
ABL.ONE Canonical Language
A high-density, binary communication protocol that enables agents to interact via strict token frames instead of natural language.
Fal AI API
A powerful media generation skill for Openclaw Skills that connects to fal.ai for professional image, video, and audio tasks.
NERRA AI Launch Engine
An AI-powered Solana token strategist designed to automate high-virality launch concepts and social marketing for Bags.fm.
Featured*
