skills.rest
NoNameItem
NoNameItemCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

completing-task

Orchestrate end-to-end task completion with branch validation, plan cleanup, and parent recursion.

Updated Jan 14, 2026
Search Tags:#workflow#task-management#bd-cli#branch-check#plan-cleanup#parent-recursion
One-click install
npx skills add https://github.com/NoNameItem/claude-tools --skill completing-task
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: completing-task
Source: https://github.com/NoNameItem/claude-tools/tree/main/plugins/flow/skills/completing-task
Command: npx skills add https://github.com/NoNameItem/claude-tools --skill completing-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the end-to-end task completion workflow for beads by enforcing branch checks, ensuring proper task closure, cleaning up implementation plans, and recursively handling parent tasks with explicit user confirmation, all while keeping the system synchronized.

Core Features & Use Cases

  • Branch validation and PR checks: On feature branches verify PR status; stop without PR and guide user to finishing-a-development-branch.
  • Find in-progress leaf tasks: Locate the current actionable in_progress leaf; handle multiple or none gracefully.
  • Close task and plan cleanup: Use bd close to finalize task; detect plan files via Plan: link or docs/plans/ and offer Delete/Archive/Keep.
  • Remove Plan link from description: Update task description when plan is deleted or archived.
  • Parent recursion with confirmation: After closing a task, recursively prompt to close any parent tasks until the user declines or no open children remain.
  • bd sync: Always run bd sync at the end to synchronize state with remote.
  • Cleanup options: If the current branch contains the task ID, offer to clean up branches/worktrees with explicit confirmation.

Quick Start

Execute flow:done on the current branch to close the selected in_progress task and trigger optional parent-cascade checks, plan cleanup, and synchronization.

Quick Start

Execute flow:done on the current branch to close the selected in_progress task and trigger optional parent-cascade checks, plan cleanup, and synchronization.

Frequently Asked Questions about completing-task

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

FAQPage Schema
How do I safely close a task and clean up plan files in a beads workflow?▼

To safely close a task in a beads workflow, the system validates your feature branch, runs bd close, and offers to delete, archive, or keep associated plan files before synchronizing state.

What happens if I try to close a feature branch task without a PR?▼

When closing a feature branch task without a PR, the system stops the closure process and guides you to finish the development branch first to ensure safe task completion.

Can I automatically close parent tasks after completing a leaf task?▼

Yes, after closing a leaf task, the system recursively prompts you to close parent tasks, continuing until you decline or no open child tasks remain.

How do I manage branch and worktree cleanup after task completion?▼

After task completion, if your current branch contains the task ID, the system offers explicit confirmation prompts to clean up branches and worktrees alongside running bd sync.

What is the best way to handle multiple in-progress leaf tasks during closure?▼

When multiple in-progress leaf tasks exist, the system gracefully handles the ambiguity by locating the current actionable leaf task and requiring explicit user confirmation before proceeding with closure.

Does the task closure workflow remove plan links from the task description?▼

Yes, when a plan file is deleted or archived during task closure, the system automatically updates the task description to remove the corresponding Plan link.

Related Skills

Explore More Software Engineering Skills→
wiggitywhitneywiggitywhitney

prd-done

Automate branch creation, commits, pull requests, merging, and issue closure via GitHub CLI.

Community
Advanced
theslashdojotheslashdojo

git-remote

Manage git remotes and synchronize local branches with remote refs.

Official
Intermediate
Ab0umarAb0umar

finishing-a-development-branch

Guide merge, PR, or cleanup decisions after tests pass.

Community
Advanced
SpiceLabsHQSpiceLabsHQ

issue-tracker-beads

Map abstract task operations to 'bd' CLI issue tracking commands.

Official
Intermediate