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.