joedaws/agent-techniques / .claude/skills/taskwork
taskwork
VerifiedUse to start or resume work under the taskwarrior convention — find or create the task for this repo, read prior handoff annotations, log decisions/gotchas during work, and leave a handoff annotation before finishing. Trigger when the user says "start work", "resume work", "log a task", "handoff", "what was I doing", or before beginning a fresh implementation session.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.6 KB |
SKILL.md
View on GitHub---
name: taskwork
description: Use to start or resume work under the taskwarrior convention — find or create the task for this repo, read prior handoff annotations, log decisions/gotchas during work, and leave a handoff annotation before finishing. Trigger when the user says "start work", "resume work", "log a task", "handoff", "what was I doing", or before beginning a fresh implementation session.
---
# Taskwork — taskwarrior convention cheat-sheet
This is the operational, invocable version of `guides/taskwarrior-workflow.md`.
Use it any time you need the exact command for a taskwarrior step, without
reading the full narrative guide.
## Find or start the task
```bash
task project:<repo> list
```
No task yet? Create one before writing code:
```bash
task add "<title>" project:<repo> +feature
task <id> start
```
## Read prior handoffs
Before doing anything else in a resumed session, read the task's
annotations — they're the last agent's (or your own past session's) notes:
```bash
task <id> information
```
## Log as you go
```bash
task <id> annotate "decision: <choice> because <reason>"
task <id> annotate "gotcha: <non-obvious constraint>"
```
## Handoff before finishing
Always leave one of these before context closes, even mid-task:
```bash
task <id> annotate "handoff: done=<...>, next=<...>, traps=<...>"
task <id> stop
```
Task fully done:
```bash
task <id> done
```
## Convention
Prefix annotations with `handoff:`, `decision:`, or `gotcha:` — nothing
else. This lets future agents `grep` the task's annotations for the kind of
context they need instead of reading everything.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |