Installs just this skill. Get the whole plugin for auto-invocation.
⚡ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/skill-finish-branch
👁️ Context preview
The summary Claude sees to decide when to auto-load this skill.
Wrap up a branch — run tests, create PR, merge or discard — use when implementation is done
📊 Stats
Stars3,869
Forks362
LanguageShell
LicenseMIT
📦 Ships with octo
</> SKILL.md
skill-finish-branch.SKILL.md
---name: skill-finish-branch
description: "Wrap up a branch — run tests, create PR, merge or discard — use when implementation is done"
trigger: |
AUTOMATICALLY ACTIVATE when user requests task completion with git operations:
- "commit and push" or "git commit and push"
- "complete all tasks and commit and push"
- "proceed with all todos in sequence and push"
- "save and commit" or "wrap this up and push"
- "I'm done with this feature" or "ready to merge"
- "create PR for this work"
DO NOT activate for:
- Individual file commits (use built-in git tools)
- Work in progress without tests passing
- Exploratory commits
- Simple "git status" or "git diff" commands
execution_mode: enforced
pre_execution_contract:
- visual_indicators_displayed
validation_gates:
- orchestrate_sh_executed
- output_artifact_exists
paths:
- ".git/**"
---# Finishing a Development Branch
**Your first output line MUST be:** `🐙 **CLAUDE OCTOPUS ACTIVATED** - Branch Completion`
## Overview
elif [[ -f "Makefile" ]] && grep -q '^test:' Makefile; then make test
fi
```
**If tests fail:** STOP. Show failures. Do not proceed.
**If tests pass:** Continue to Step 2.
---
### Step 2: Multi-Provider Diff Review
**Run a quick multi-provider review of the changes before shipping.** This catches issues before they reach PR reviewers.
```bash
# Get the diff summary
DIFF_STAT=$(git diff --stat $(git merge-base HEAD main)..HEAD)
DIFF_FILES=$(git diff --name-only $(git merge-base HEAD main)..HEAD)
```
**Always run a quick review — this is automatic, not optional:**
```bash
# Quick review via orchestrate.sh (uses available providers)
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh spawn reviewer "Review this diff for bugs, security issues, and code quality problems. Be concise — only flag real issues, not style preferences.
$(git diff $(git merge-base HEAD main)..HEAD | head -500)"
```
**If critical issues found:** Present them and ask whether to fix or ship anyway.
**If clean:** Continue to Step 3. Show a brief `✓ Review clean — no issues found`.
