release-tasks

Release claimed tasks back to a shared work queue by slug.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/bismuthdigital/claude-project-template --skill release-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-tasks
Source: https://github.com/bismuthdigital/claude-project-template/tree/main/.claude/skills/release-tasks
Command: npx skills add https://github.com/bismuthdigital/claude-project-template --skill release-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires work-queue.sh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows agents to release claimed tasks back into the work queue, preventing stale claims and ensuring tasks are available for other agents when work is abandoned, blocked, or needs manual cleanup.

Core Features & Use Cases

  • Release All Claims: Frees all tasks currently claimed by the worktree.
  • Release Specific Task: Releases a single task identified by its slug.
  • Expire Stale Claims: Removes claims that have exceeded their Time-To-Live (TTL) and automatically releases merged PR claims.
  • Use Case: If you start working on a task but realize it's blocked by an external dependency, you can use /release-tasks <slug> to return it to the queue instead of letting it sit unclaimed.

Quick Start

Use the release-tasks skill to return all tasks claimed by this worktree back to the queue.

Frequently Asked Questions about release-tasks

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

FAQPage Schema
How do I release claimed tasks back to a shared work queue for agent reassignment?

To release claimed tasks back to a shared work queue, use the release-tasks command to free all tasks claimed by the worktree or target a specific task by slug, making it available for other agents.

Why do my agent workflow tasks sit unclaimed and blocked indefinitely?

Tasks sit unclaimed when agents abandon work or hit external blocks. Expire stale claims using TTL limits and merged PR detection to automatically return blocked workflow tasks to the queue.

How do I return a single blocked task to the work queue using its slug?

Return a single blocked task to the work queue by passing its slug to the release command, which removes your claim and makes that specific task available for agent reassignment.

Can I automatically expire stale task claims in an agentic workflow?

Yes, you can automatically expire stale task claims by enforcing a Time-To-Live TTL threshold, which removes inactive claims and releases merged PR claims to prevent task stagnation.

Does work-queue.sh support releasing all tasks claimed by a worktree at once?

Yes, the work-queue.sh dependency supports releasing all tasks claimed by a worktree simultaneously, allowing bulk cleanup when work is abandoned or manual reset is needed.

When should I manually release tasks instead of waiting for automatic expiration?

Manually release tasks when you recognize work is blocked by an external dependency, preventing stagnation and immediately returning the task to the queue instead of waiting for TTL expiration.