issue-finish

Merge feature branches, push updates, remove worktrees, delete branches, and close issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chiyonn/dotfiles --skill issue-finish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-finish
Source: https://github.com/chiyonn/dotfiles/tree/main/dot_claude/skills/issue-finish
Command: npx skills add https://github.com/chiyonn/dotfiles --skill issue-finish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the cleanup after an issue is completed by performing a series of repository housekeeping tasks: merging the feature branch into main, pushing updates, removing worktrees, deleting the branch, cleaning up related folders, and closing the corresponding issue.

Core Features & Use Cases

  • Merge and push: integrate the feature branch into main and push to origin.
  • Worktree and branch cleanup: remove local worktrees and delete the finished branch.
  • Automation of issue lifecycle: close the issue automatically when work is complete.

Quick Start

Finish issue 19 by performing cleanup: merge to main, push, remove the worktree, delete the branch, and close the issue.

Frequently Asked Questions about issue-finish

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

FAQPage Schema
How do I automate git branch cleanup and issue closure after finishing a feature?

Automating git branch cleanup and issue closure involves merging the feature branch into main, pushing updates, removing worktrees, deleting the branch, and closing the corresponding GitHub issue.

Can I remove a git worktree and delete the branch in one step?

Yes, you can remove a git worktree and delete its associated branch together as part of a post-issue cleanup workflow that also merges changes into main and closes the linked issue.

How does closing a GitHub issue with gh CLI work alongside local branch deletion?

Closing a GitHub issue with gh CLI alongside local branch deletion works by integrating the feature branch into main, pushing to origin, removing the worktree, and then running the closure command.

Do I need gh CLI installed to automate issue lifecycle cleanup?

Yes, you need gh CLI installed to automate issue lifecycle cleanup, as the process relies on standard Git commands and the GitHub CLI to close issues and manage remote repository state.

What is the best way to clean up local worktrees after merging a feature branch?

The best way to clean up local worktrees after merging a feature branch is to automate the full sequence: merge to main, push to origin, remove the worktree directory, delete the branch, and close the issue.

Why does post-issue cleanup require git 2.17 or higher?

Post-issue cleanup requires git 2.17 or higher because the worktree removal and branch management commands used in the automated workflow depend on features available from that version onward.