finish-issue

Automate GitHub issue closure with test verification, PR creation, and umbrella tracking.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/N0K0/claude-plugins-backalley --skill finish-issue-n0k0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finish-issue
Source: https://github.com/N0K0/claude-plugins-backalley/tree/main/plugins/process/skills/finish-issue
Command: npx skills add https://github.com/N0K0/claude-plugins-backalley --skill finish-issue-n0k0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually wrapping up completed GitHub issues is error-prone and time-consuming, requiring repeated checks for passing tests, proper PR creation with closure tags, parent issue tracking, and worktree cleanup that are easy to skip or mess up.

Core Features & Use Cases

  • Pre-closure validation: Automatically checks for the in-progress label, fully completed implementation checklists, and passing test suites before allowing any closure work to proceed.
  • Flexible merge paths: Supports three merge options: PR merge with automatic GitHub issue closure, leaving the PR open for external review, or local merge with manual state syncing to GitHub.
  • Umbrella issue tracking: Automatically checks off parent umbrella issues when all child tasks are complete, with recursive checking up to 5 levels to avoid cycles.
  • Use Case: For development teams using GitHub Issues to track work, this skill eliminates manual overhead and mistakes when closing out completed features, bug fixes, or tasks.

Quick Start

Use the finish-issue skill to wrap up all closure steps for completed GitHub issue #42, including test verification, PR creation, and parent issue checkoff.

Frequently Asked Questions about finish-issue

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

FAQPage Schema
How do I automate GitHub issue closure and PR creation?

Automate GitHub issue closure by validating completed implementation checklists and passing test suites, then create PRs with auto-closure tags. This eliminates manual validation and PR creation overhead for development workflows.

How does umbrella issue tracking work when closing child tasks?

Umbrella issue tracking automatically checks off parent issues when all child tasks are complete, recursively checking up to 5 levels to avoid cycles. This ensures parent GitHub issues are accurately updated without manual intervention.

What are the merge options for closing GitHub issues with test verification?

Test verification supports three merge options: PR merge with automatic GitHub issue closure, leaving the PR open for external review, or local merge with manual state syncing to GitHub. Worktree cleanup occurs after merge operations.

Do I need completed implementation checklists before closing a GitHub issue?

Yes, pre-closure validation requires fully completed implementation checklists, passing test suites, and the removal of the in-progress label before allowing any GitHub issue closure work to proceed.

Can I leave a PR open for external review while syncing local merge state to GitHub?

Yes, you can leave the PR open for external review or perform a local merge with manual state syncing to GitHub. Both paths still execute pre-closure test verification and worktree cleanup after merge operations.