block-task

Block tasks under .agents/workspace/active and record the blocking reason.

84|5|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/fitlab-ai/agent-infra --skill block-task
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: block-task
Source: https://github.com/fitlab-ai/agent-infra/tree/main/.agents/skills/block-task
Command: npx skills add https://github.com/fitlab-ai/agent-infra --skill block-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a safe, auditable way to mark a task as blocked and capture the reason, preventing further work until the blocker is resolved.

Core Features & Use Cases

  • Update the task metadata to status: blocked and move the task directory to a blocked state.
  • Append an entry to the Activity Log with a timestamped blocking record and ensure the original records remain intact.
  • Optional: sync with related issues when available to keep cross-system alignment.

Quick Start

Identify a blocked task and run the block-task flow to move it to blocked and record the reason.

Frequently Asked Questions about block-task

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

FAQPage Schema
How do I block a task and log the reason in a project workflow?▼

To block a task, the workflow updates the task metadata to a blocked status, moves the task directory to a blocked state, and appends a timestamped entry to the Activity Log to prevent further progress until the blocker is resolved.

What happens to task metadata when a task is blocked?▼

Blocking a task updates the task.md metadata to status: blocked and moves the task directory from the active workspace to a blocked directory, ensuring no further work occurs on it.

Can I sync blocked tasks with an external issue tracker?▼

Yes, when a task is blocked, the system optionally syncs the blocking status and reason with related issues in external issue trackers to maintain cross-system alignment.

How do I unblock a task after the blocker is resolved?▼

The system provides specific steps for unblocking and validation, allowing you to reverse the blocked status and move the task back to the active directory for continued progress.

Does blocking a task overwrite previous Activity Log records?▼

No, blocking a task appends a new Blocked entry to the Activity Log with a timestamp while ensuring the original records remain completely intact and unaltered.