complete_task

Report task completion status with success, blocked, or partial outcomes.

5|1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/xztxy/openwork --skill complete-task-xztxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complete_task
Source: https://github.com/xztxy/openwork/tree/main/packages/agent-core/mcp-tools/complete-task
Command: npx skills add https://github.com/xztxy/openwork --skill complete-task-xztxy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool is essential for signaling the end of a task, whether it's successfully completed, blocked, or only partially finished, ensuring clear communication with the agent.

Core Features & Use Cases

  • Task Status Reporting: Clearly defines the outcome of a task (success, blocked, partial).
  • Progress Summarization: Requires a summary of accomplishments and remaining work when applicable.
  • Use Case: After an agent attempts to write a blog post, it should call complete_task with status: "success" and a summary of the post, or status: "blocked" with a summary of what was done and remaining_work explaining the blocker.

Quick Start

Call the complete_task tool with status success, original request summary "Write a poem about a cat", and summary "Wrote a poem about a cat named Whiskers."

Frequently Asked Questions about complete_task

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

FAQPage Schema
How do I signal task completion status for an AI agent?

To signal task completion status for an AI agent, you call the complete_task tool to explicitly report success, blocks, or partial completion. This ensures a structured and auditable end to the task.

What is the best way to report an AI agent's blocked workflow status?

The best way to report a blocked workflow status is to call complete_task with the status set to "blocked". You must provide a summary of what was accomplished and detail the remaining work explaining the blocker.

How does task completion reporting structure partial progress?

Task completion reporting structures partial progress by requiring a summary of the original request and accomplished work. When a task is not fully completed, it mandates an optional field for detailing remaining tasks.

Can I use task status reporting without documenting the original request?

No, you cannot use task status reporting without documenting the original request. The tool mandates a summary of the original request and the accomplished work to ensure clear communication and a structured end.

When do I need to provide remaining work details in task completion reporting?

You need to provide remaining work details in task completion reporting when a task is not fully completed. This optional field is used alongside the status and summary to explain what is left to be done.