agent-team-task-block

Block a task in agent-team workflows when the assigned agent cannot proceed.

2|Updated May 10, 2026
One-click install
npx skills add https://github.com/tae2089/agent-team --skill agent-team-task-block
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-team-task-block
Source: https://github.com/tae2089/agent-team/tree/main/skills/agent-team-task-block
Command: npx skills add https://github.com/tae2089/agent-team --skill agent-team-task-block

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to explicitly mark a task as blocked when the assigned agent cannot proceed, creating visibility and a traceable reason to inform handoffs and risk management.

Core Features & Use Cases

  • Mark a task as blocked with a clear, actionable reason to unblock or reassign work.
  • Enforce required inputs (task_id, agent, and reason) and surface guidance in error scenarios.
  • Use cases include dependency gaps, missing information, or decisions blocking progress, with quick references to related skills for reassignment or retry.

Quick Start

Block a task by running agent-team task block with the task ID, the reporting agent, and an actionable reason.

Frequently Asked Questions about agent-team-task-block

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

FAQPage Schema
How do I mark a task as blocked in an agent-team workflow?

To block a task in an agent-team workflow, you must provide the task ID, the reporting agent, and an actionable reason. This explicitly halts progress and creates a traceable record for handoffs.

What happens if required fields are missing when blocking a task?

Blocking a task enforces required fields like task_id, agent, and reason. If these are missing, the process triggers error handling and surfaces guidance to ensure the blocker is properly documented.

When should I block a task instead of reassigning it directly?

You should block a task when an agent cannot proceed due to missing inputs, dependencies, or decisions. This creates visibility and provides a clear reason before attempting reassignment or retry.

Can I track dependency gaps that halt project management workflows?

Yes, blocking a task tracks dependency gaps by requiring an actionable reason for the halt. This records the specific missing information or decision needed to resume the project workflow.

What is the best way to handle missing information during task execution?

The best way to handle missing information is to block the task with a clear reason. This surfaces the specific gap, enforces visibility, and informs risk management or reassignment efforts.

Does blocking a task provide guidance for retrying or reassigning work?

Yes, blocking a task provides error handling and guidance for reassignment or retry. It ensures the assigned agent has a traceable reason to inform the next steps in the workflow.