taskwarrior

Filter urgent Taskwarrior tasks and render markdown documentation from annotations.

23|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/tta-lab/ttal-cli --skill taskwarrior-tta-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taskwarrior
Source: https://github.com/tta-lab/ttal-cli/tree/main/skills/taskwarrior
Command: npx skills add https://github.com/tta-lab/ttal-cli --skill taskwarrior-tta-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires task, python3, json, subprocess, pathlib, re, and includes scripts (resource) components.

What problem does it solve?

Taskwarrior task management can be powerful, but it often lacks smart, opinionated workflows for surfacing urgency and keeping the right planning context close to the task.

Core Features & Use Cases

  • Smart notifications: Runs urgent checks (overdue, due soon, stale high-priority, and suggestions when nothing urgent exists) via a cron-friendly script.
  • Markdown-first task context: Opens a task and automatically renders any referenced local markdown documentation embedded in annotations.
  • Dependency-safe workflows: Encourages using Taskwarrior’s depends: field for blocking/unblocking while keeping annotations focused on reasoning and supporting documents.
  • Task lifecycle helper scripts: Supports common operations like viewing task details with linked documentation and automating worker follow-up task creation patterns.

Quick Start

Run the urgent notification checker to see what needs attention: ~/clawd/skills/taskwarrior/scripts/check-urgent-tasks.py

Frequently Asked Questions about taskwarrior

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get notifications for urgent Taskwarrior tasks?

Run the urgent notification checker script to scan exported task JSON for overdue, due soon, and stale high-priority tasks, generating alerts when items need immediate attention.

Can I view markdown documentation linked inside Taskwarrior annotations?

Yes, the task viewer parses annotation text for file paths with ~ expansion and automatically renders referenced local markdown documentation alongside task details.

How does task triage work with projects, tags, and priorities in Taskwarrior?

Triage filters pending task queues using exported task JSON, applying urgency logic across projects, tags, priorities, and due dates to suggest what needs action next.

Does Taskwarrior dependency tracking work with this task management workflow?

Yes, the workflow uses Taskwarrior's `depends:` field for blocking and unblocking tasks while keeping annotations focused on reasoning and supporting markdown documents.

What do I need to run automated Taskwarrior task scripts?

You need Python3, the `task` CLI, and standard libraries like json, subprocess, pathlib, and re to execute scripts that export and process task data.

What happens when there are no urgent tasks in Taskwarrior?

When nothing urgent exists, the notification script provides suggestions based on your pending task queue, ensuring you still receive actionable recommendations for daily task management.