finishing-branches

Run pre-merge checks, scan for secrets, and prepare pull requests on feature branches.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/BPSAI/paircoder --skill finishing-branches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-branches
Source: https://github.com/BPSAI/paircoder/tree/main/tools/cli/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.claude/skills/finishing-branches
Command: npx skills add https://github.com/BPSAI/paircoder --skill finishing-branches

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures branches reach a merge-ready state by running gates (tests, linting, type hints) and preparing pull requests.

Core Features & Use Cases

  • Gate-based completion: Run tests and lint checks before finishing.
  • PR guidance: Instructions for creating and linking PRs.
  • Post-merge rinse: Steps to clean up branches after merge.

Quick Start

Run pre-merge checks, update task status, and create a PR with autop-run.

Frequently Asked Questions about finishing-branches

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

FAQPage Schema
How do I ensure my feature branch is ready to merge with automated checks?

Run pre-merge validation to execute unit tests, linting, and type hints on your branch. This Skill enforces a merge-ready state by automating gate checks before pull request creation, catching issues early and reducing manual review friction.

What security checks happen before merging a branch?

The Skill performs secret scanning on your branch to detect exposed credentials or sensitive data before merge. Security validation runs alongside functional tests, ensuring both code quality and credential safety in your CI workflow.

Can I automate pull request creation after branch validation?

Yes. After passing pre-merge checks, the Skill auto-generates and prepares a pull request with diff summaries and task-status updates. This streamlines the handoff from feature completion to code review and merge.

How do I clean up after merging a feature branch?

The Skill includes post-merge housekeeping steps that handle branch cleanup and workflow finalization. This ensures your repository stays organized and task statuses reflect completed work after successful merge.

What happens if tests or linting fails during branch finishing?

Failed checks block the merge-ready state and pull request creation, surfacing errors and lint violations for you to fix. The workflow stops before PR submission, forcing resolution of quality gates before proceeding.

Does this work with CI-enabled Git workflows?

Yes. This Skill integrates with CI-enabled Git feature branch workflows, automating validation gates and PR preparation as part of standard merge pipelines. It applies across repositories using continuous integration practices.

Related Skills