- name
- taskwarrior
- description
- >
- metadata
- |
Taskwarrior (Workspace-Local Tasks) — AgentSkill
Skill name
taskwarrior
Purpose
Manage tasks using Taskwarrior as the backend with data stored inside the current workspace. This skill provides a safe, workspace-scoped wrapper for common Taskwarrior operations (add/list/modify/done/projects/tags/due/priority/annotations).
Runtime requirements (ClawHub)
This skill requires Taskwarrior to already be available in the runtime environment (e.g., included in the base image).
- Validation: run
task --version - If missing: report the dependency and instruct the environment owner to install system package taskwarrior (some distros package it as task).
This skill does not perform system-level installs (no apt, brew, dnf, etc.).
Workspace root resolution (portable)
The skill resolves the workspace root at runtime: 1) If set, use the first available of: - OPENCLAW_WORKSPACE - WORKSPACE - PROJECT_DIR - REPO_ROOT 2) Otherwise, fallback to the current working directory.
All Taskwarrior data is stored under: <workspace>/.openclaw/taskwarrior/
Workspace-local Taskwarrior home
- taskrc:
<workspace>/.openclaw/taskwarrior/taskrc - data dir:
<workspace>/.openclaw/taskwarrior/.task/
Every Taskwarrior command MUST run with:
TASKRC=<workspace>/.openclaw/taskwarrior/taskrc- (optional)
TASKDATA=<workspace>/.openclaw/taskwarrior/.task
Never write to global ~/.task or ~/.taskrc unless the user explicitly asks to use global storage.
Core workflow
1) Check dependency - Run: task --version - If missing: stop and return dependency instructions (see references/clawhub_notes.md).
2) Initialize workspace storage - Ensure directories exist: - <workspace>/.openclaw/taskwarrior/ - <workspace>/.openclaw/taskwarrior/.task/ - Ensure <workspace>/.openclaw/taskwarrior/taskrc contains at least: - data.location=<workspace>/.openclaw/taskwarrior/.task - confirmation=off - verbose=off
3) Execute requested operations - Prefer stable/common commands (see references/taskwarrior_cheatsheet.md).
4) Verify results - After any mutation, show a focused task <id> info or filtered task <filter> list.
Supported operations (useful subset)
- Add tasks:
task add ... - List tasks:
task list,task <filter> list - Modify tasks:
task <id> modify ... - Complete tasks:
task <id> done - Start/stop:
task <id> start|stop(if desired) - Projects/tags:
task projects,task tags,project:<name>,+tag,-tag - Due/priorities:
due:<date>,priority:H|M|L - Notes:
task <id> annotate "..."
Safety
Follow references/safe_command_policy.md. Highlights:
- No delete/purge unless explicitly requested.
- Avoid broad bulk changes without previewing the matching set.
- No global config writes by default.
References
- references/workspace_data_layout.md
- references/taskwarrior_cheatsheet.md
- references/safe_command_policy.md
- references/examples.md
- references/clawhub_notes.md