Skill

complete-task

Marks taskmd tasks as completed: verifies subtasks and acceptance criteria, checks off items, adds worklogs if enabled, handles PR-review workflow, runs verification checks.

Bash

Markdown

cli-tools

automation

npx claudepluginhub driangle/taskmd --plugin taskmd

Tool Access

This skill is limited to using the following tools:

BashReadEdit

Preview

Mark a task as completed using the `taskmd` CLI.

SKILL.md

Similar Skills

complete-task

Marks tasks as completed after verifying subtasks, acceptance criteria, optional verify checks (bash/assert), and worklogs. Handles solo and PR-review workflows.

4 tools

taskmd-lite

complete

129

Marks ClickUp tasks as complete after user confirms all checklist items, adding a summary comment. Prevents closing unfinished tasks by listing incompletes and suggesting fixes.

clickup

do-task

Looks up task by ID or name with taskmd, reads details, marks in-progress, starts worklog if enabled, executes using tools like EnterPlanMode, and completes it. Use to pick up and run predefined tasks.

8 tools

taskmd

Stats

Parent Repo Stars16

Parent Repo Forks2

Last CommitMar 14, 2026

Used By2 plugins

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Complete Task

Mark a task as completed using the taskmd CLI.

Instructions

The user's query is in $ARGUMENTS (a task ID like 077). If $ARGUMENTS is empty or does not contain a task ID, infer the task from conversation context (e.g., the task currently being worked on). If the task cannot be determined, ask the user which task to complete.

Read the task file to understand the full task scope:

Run taskmd show <ID> to get the task contents
Identify all subtask checklists (- [ ] / - [x] items) in the task body
Identify any acceptance criteria section

Verify subtasks and acceptance criteria are met:

Review each subtask checklist item — confirm the work has been done
Review each acceptance criterion — confirm it is satisfied
Check off (- [x]) any items that are complete but not yet checked off by editing the task file
If any items are genuinely incomplete, report them to the user and ask how to proceed — do NOT mark the task as completed

Add a final worklog entry (if worklogs are enabled):

Check .taskmd.yaml for worklogs: true -- only create worklogs if explicitly enabled; skip this step otherwise
Otherwise, find the worklog file at tasks/<group>/.worklogs/<ID>.md (or tasks/.worklogs/<ID>.md)
If a worklog exists, append a timestamped completion summary

Check the workflow mode in .taskmd.yaml:

If workflow: pr-review is set, use taskmd set $ARGUMENTS --status in-review instead of completed (note: in pr-review mode, tasks are completed by merging the PR, not by setting status directly)
Otherwise (default solo mode), run taskmd set $ARGUMENTS --status completed --verify
The --verify flag runs any verification checks defined in the task before applying the status change
If verification fails, report the failures to the user

Confirm the status change to the user

Complete Task

Mark a task as completed using the taskmd CLI.

Instructions

Read the task file to understand the full task scope:
- Run taskmd show <ID> to get the task contents
- Identify all subtask checklists (- [ ] / - [x] items) in the task body
- Identify any acceptance criteria section
Verify subtasks and acceptance criteria are met:
- Review each subtask checklist item — confirm the work has been done
- Review each acceptance criterion — confirm it is satisfied
- Check off (- [x]) any items that are complete but not yet checked off by editing the task file
- If any items are genuinely incomplete, report them to the user and ask how to proceed — do NOT mark the task as completed
Add a final worklog entry (if worklogs are enabled):
- Check .taskmd.yaml for worklogs: true -- only create worklogs if explicitly enabled; skip this step otherwise
- Otherwise, find the worklog file at tasks/<group>/.worklogs/<ID>.md (or tasks/.worklogs/<ID>.md)
- If a worklog exists, append a timestamped completion summary
Check the workflow mode in .taskmd.yaml:
- If workflow: pr-review is set, use taskmd set $ARGUMENTS --status in-review instead of completed (note: in pr-review mode, tasks are completed by merging the PR, not by setting status directly)
- Otherwise (default solo mode), run taskmd set $ARGUMENTS --status completed --verify
- The --verify flag runs any verification checks defined in the task before applying the status change
- If verification fails, report the failures to the user
Confirm the status change to the user