complete-task

name	Complete Task
description	Mark a task as complete with a summary of the work done.
version	1.2.0
category	task-management
skillType	claude-skill
assignableRoles	["developer","qa","tpm","designer","frontend-developer","backend-developer","fullstack-dev","qa-engineer","product-manager","architect","generalist","sales","support"]
triggers	["complete task","finish task","mark done","task done"]
tags	["task","completion","status"]
execution	{"type":"script","script":{"file":"execute.sh","interpreter":"bash","timeoutMs":15000}}

Complete Task

Mark a task as complete with a summary of the work done. If the task has an output schema, provide structured output that will be validated against the schema. Optionally skip quality gates if they have already been verified separately.

Parameters

Parameter	Required	Description
workItemId	Preferred	ID of the V3 WorkItem to complete. This is the only input that selects the WorkItem
sessionName	Yes	Your agent session name
summary	Yes	Summary of the work completed
absoluteTaskPath	No	Legacy (V1). Still accepted so older callers keep working, but it does NOT identify a WorkItem
output	No	Structured output object (required if task has an output schema)
skipGates	Rejected	Not supported. This endpoint runs no quality gates, so there is nothing to skip. Passing it is a hard error. Use the check-quality-gates skill for gates.

Which WorkItem gets completed

Resolution order:

1. workItemId, if you pass it — always wins.
2. Otherwise, a lookup of the WorkItem currently running against your sessionName (GET /api/task-pool/items?status=running&target=<session>).
3. If neither resolves, the skill exits non-zero with an error naming the session it searched. It never reports success without completing something.

Pass workItemId whenever you know it — the lookup in step 2 depends on the pool state at that instant and cannot disambiguate two concurrently running items for one session.

Example

bash config/skills/agent/core/complete-task/execute.sh '{"workItemId":"wi-abc123","sessionName":"dev-1","summary":"Implemented login form with validation and tests"}'

Letting the skill resolve your running WorkItem

bash config/skills/agent/core/complete-task/execute.sh