podikoglou

taskwarrior-manager

Manages tasks using Taskwarrior with strict adherence to project and tag requirements. Enforces mandatory project assignment, tagging, and task lifecycle rules (start before work, done after completion). Ensures agent-created tasks are attributed with +agent tag.

podikoglou 0 Updated 4mo ago
GitHub

Install

npx skillscat add podikoglou/taskwarrior-skill

Install via the SkillsCat registry.

SKILL.md

Taskwarrior Manager

This skill provides instructions for managing tasks via the Taskwarrior command-line tool.
It enforces strict rules to ensure data consistency, trackability, and proper task lifecycle management.

When to use this skill

Use this skill when you need to:

  • Look at what tasks need to be done
  • Note tasks that need to be done in the future
  • Manage your tasks

Usage

How to view tasks

The main command is: task

How to query

You can query tasks in the project foo using:
task project:foo

You can query by the tags foo and bar using:
task +foo +bar

You can combine them (look for tasks in the project foo with tag bar): task project:foo +bar

How to mark a task as in progress

Use its ID (first column in the output of task)
For example, to mark task 3 as in progress: task start 3

How to mark a task as done

Use its ID (first column in the output of task)
For example, to mark task 3 as in progress: task done 3

How to add a new task

You can add a task titled 'hello world' with the tag bar, in project foo with:
task add project:foo +bar hello world

A task can depend on other tasks. Here's how to create a task that depends on tasks 3 and 4
task add project:foo +bar depends:3,4 hello world

How to modify a task

To modify a task you first use the same syntax for querying tasks (you can just
use the task ID you have it instead) then the mod command, then the updated
properties.

To modify task 4 and add the bar tag, do: task 4 mod +bar
To change the project of task 4 to foo, do task 4 mod project:foo
To change the dependencies of task 4 to 2 and 3, do task 4 mod depends:2,3

NOTE: You cannot append a dependency; if you want to add a new dependency,
re-specify all the dependencies.

``

Rules

  1. Every task must always belong to a project
  2. Every task must have at least one tag
  3. When you (the agent) create a task you must always add the +agent tag
  4. Before starting work on a task you must always mark it as in progress
  5. After finishing a task you must always mark it as done