skills.rest
cooper538
cooper538COMMUNITY
Explore all skills by this author →
GitHub

finish-task

Automate task completion with status updates, tests, and mode-aware Git merges.

Updated Jan 23, 2026
Search Tags:#automation#git#testing#merge#task-management#branch-cleanup#finish-task
One-click install
npx skills add https://github.com/cooper538/eshop-demo --skill finish-task-cooper538
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finish-task
Source: https://github.com/cooper538/eshop-demo/tree/main/.claude/skills/finish-task
Command: npx skills add https://github.com/cooper538/eshop-demo --skill finish-task-cooper538

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates finishing the current development task by updating task status, preparing commits, and performing mode-aware merges across MAIN, FEATURE_BRANCH, and WORKTREE workflows.

Core Features & Use Cases

  • Mode detection: Detects whether in MAIN, FEATURE_BRANCH, or WORKTREE and applies the correct merge/commit strategy.
  • Prerequisite checks: Ensures no uncommitted changes (unless --force), runs tests (unless --no-test), and formatting checks.
  • Mode-specific actions: MAIN updates task status only; FEATURE_BRANCH performs squash merge into main with a commit; WORKTREE performs squash merge in the main repo with optional worktree cleanup.
  • Task status & cleanup: Marks tasks complete and performs branch operations accordingly.

Quick Start

Run the finish-task command to complete the current task with automatic mode detection. Optional flags: --no-test to skip tests, --force to override safety checks.

Frequently Asked Questions about finish-task

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

FAQPage Schema
How do I automate finishing a development task and merging a git feature branch?▼

Automating task finishing involves detecting the current Git workflow mode, running tests, performing a squash merge into the main branch, and cleaning up the feature branch.

What is the best way to finalize git commits in a worktree without uncommitted changes?▼

Finalizing git commits in a worktree requires having no uncommitted changes, after which the system performs a squash merge in the main repository with optional worktree cleanup.

Can I skip tests and override safety checks when completing a task on the main branch?▼

Yes, you can skip tests using the --no-test flag and override uncommitted changes safety checks using the --force flag when completing tasks on the main branch.

Does task completion support different git workflow modes like feature branch and worktree?▼

Yes, task completion supports MAIN, FEATURE_BRANCH, and WORKTREE workflows, applying mode-specific commit strategies and merge actions tailored to each Git repository setup.

Why does the branch cleanup fail when I have uncommitted code formatting changes?▼

Branch cleanup fails because the system enforces prerequisites including no uncommitted changes and successful code formatting checks to ensure safe task finalization.

Related Skills

Explore More Software Engineering Skills→
n0rvynn0rvyn
1

finish-branch

Run tests and integrate a completed feature branch via git or gh commands.

Community
Intermediate
glhewettglhewett

git-feature-complete

Merge feature branches into main and delete them after passing checks.

Community
Intermediate
wizactwizact

worktree

Automate Git worktree creation, cleanup, and synchronization for feature branches.

Community
Advanced
woodrowpearsonwoodrowpearson

finishing-a-development-branch

Automate branch finalization with merge, PR, keep, or discard options.

Community
Basic