finishing-a-development-branch SKILL.md skillA

finishing-a-development-branch from obra/superpowers is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add obra/superpowers/finishing-a-development-branch@git:20260812.b36e082

Pins git:20260812.b36e082 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
obra/superpowers
Path
skills/finishing-a-development-branch/SKILL.md
Versions recorded
5
Latest version
git:20260812.b36e082, committed Aug 12, 2026
First version recorded
Jul 24, 2026
Size
7,781 bytes
Repository stars
302,424
License
MIT

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Finishing a Development Branch

## Overview

**Core principle:** Verify tests → Detect environment → Present options → Execute choice → Clean up.

**Announce at start:** "I'm using the finishing-a-development-branch skill to complete this work."

## Step 1: Verify Tests

Run the project's full test suite (`npm test` / `cargo test` / `pytest` / `go test ./...`).

**If tests fail**, report the failures and stop — the menu comes after a green suite:

```
Tests failing (<N> failures). Must fix before completing:

[Show failures]
```

**If tests pass:** continue to Step 2.

## Step 2: Detect Environment

```bash
GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
# Capture now, while still inside the workspace — Step 5 changes directory
# before cleanup (Step 6) needs this value
WORKTREE_PATH=$(git rev-parse --show-toplevel)
```

This determines which menu to show and how cleanup works:

| State | Menu | Cleanup |
|-------|------|---------|
| `GIT_DIR == GIT_COMMON` (normal repo) | Standard 3 options | No worktree to clean up |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add obra/superpowers/finishing-a-development-branch@sha256:8db5a922b242dd4e

The line at the top of this page pins the label git:20260812.b36e082, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_twhjrpwqvsi5uum5.svg)](https://markdownregistry.com/a/art_twhjrpwqvsi5uum5)

7 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 24, 2026 and Aug 12, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260812.b36e082 latest2026-08-12 b36e082 7,781 BA view · diff
git:20260724.0b472192026-07-24 0b47219 7,022 BA view · diff
git:20260724.9dff1a92026-07-24 9dff1a9 7,872 BA view · diff
git:20260724.bcfe7982026-07-24 bcfe798 7,895 BA view · diff
git:20260724.fbb6dba2026-07-24 fbb6dba 6,860 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7781 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

obra/superpowers · 302,424 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_twhjrpwqvsi5uum5
GET https://markdownregistry.com/api/v1/resolve?ref=obra/superpowers/finishing-a-development-branch
GET https://markdownregistry.com/api/v1/blob/8db5a922b242dd4e1bf824cb91c13b3e8d8e8a86d6ceaf7f0774eb9cce909d65

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from obra/superpowers

AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
brainstorming SKILL.md skill
obra/superpowers · skills/brainstorming/SKILL.md · You MUST use this before any creative work - creating features, building components, adding functionality, modifying…
git:20261010.bb92a77 · audit A · 302,424 stars
diagnosing-superpowers SKILL.md skill
obra/superpowers · skills/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260919.5bf4e78 · audit A · 302,424 stars
dispatching-parallel-agents SKILL.md skill
obra/superpowers · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
git:20260724.6dbbbda · audit A · 302,424 stars
executing-plans SKILL.md skill
obra/superpowers · skills/executing-plans/SKILL.md · Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose…
git:20260919.5bf4e78 · audit A · 302,424 stars
receiving-code-review SKILL.md skill
obra/superpowers · skills/receiving-code-review/SKILL.md · Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or…
git:20260724.3fb7597 · audit A · 302,424 stars
requesting-code-review SKILL.md skill
obra/superpowers · skills/requesting-code-review/SKILL.md · Use when completing tasks, implementing major features, or before merging to verify work meets requirements
git:20261010.bb92a77 · audit A · 302,424 stars
subagent-driven-development SKILL.md skill
obra/superpowers · skills/subagent-driven-development/SKILL.md · Use when executing implementation plans with independent tasks in the current session
git:20260919.5bf4e78 · audit A · 302,424 stars
systematic-debugging SKILL.md skill
obra/superpowers · skills/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
git:20261010.bb92a77 · audit A · 302,424 stars
test-driven-development SKILL.md skill
obra/superpowers · skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code
git:20260919.5bf4e78 · audit A · 302,424 stars
using-git-worktrees SKILL.md skill
obra/superpowers · skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans -…
git:20260724.bc86802 · audit A · 302,424 stars
using-superpowers SKILL.md skill
obra/superpowers · skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY…
git:20260919.5bf4e78 · audit A · 302,424 stars

Every file in obra/superpowers

Other files named finishing-a-development-branch

finishing-a-development-branch SKILL.md skill
jnmetacode/superpowers-zh · skills/finishing-a-development-branch/SKILL.md · 当实现完成、所有测试通过、需要决定如何集成这份工作时使用
v1.0.0 · audit A · 8,348 stars
finishing-a-development-branch SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete, all tests pass, and you need to decide how to integrate the work.
git:20260601.da7723a · audit A · 1,856 stars
finishing-a-development-branch SKILL.md skill
ganyuanran/aegis · skills/finishing-a-development-branch/SKILL.md · Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly…
git:20261010.8d5b88e · audit A · 1,371 stars
finishing-a-development-branch SKILL.md skill
coco-research/coco · skills/finishing-a-development-branch/SKILL.md · Use when implementation is done and tests pass and the user must choose to merge locally, open a PR, keep the branch…
git:20260914.e75f220 · audit A · 827 stars
finishing-a-development-branch SKILL.md skill
xu123-bob/baize · agent/skills/superpowers/5.1.0/skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides…
git:20260912.5e131e8 · audit A · 581 stars
finishing-a-development-branch SKILL.md skill
jamditis/claude-skills-journalism · superjawn/skills/finishing-a-development-branch/SKILL.md · Presents options for merge, PR, or cleanup. Use when work is complete, tests pass, and you must decide how to integrate.
git:20260818.3e0e3a8 · audit A · 427 stars
finishing-a-development-branch SKILL.md skill
ibrahim-3d/orchestrator-supaconductor · skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides…
git:20260327.87e3ef5 · audit A · 380 stars
finishing-a-development-branch SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-plan-and-execute/skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides…
git:20260616.eb1d79c · audit A · 253 stars

Browse by kind, by grade A, or by owner.