CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

finishing-a-development-branch

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

1.92x
Quality

85%

Does it follow best practices?

Impact

98%

1.92x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is finishing-a-development-branch in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A high-quality procedural skill body: concrete commands, exact dialogue templates, and an explicitly gated workflow with validation at every risky point. The main weaknesses are minor — duplicated rule statements across Common Mistakes and Red Flags, and a generic test-command enumeration instead of a detection step.

Suggestions

Consolidate 'Common Mistakes' and 'Red Flags' into a single section — they currently repeat the same rules (never proceed on failing tests, never delete without confirmation) in slightly different forms.

Replace the 'npm test / cargo test / pytest / go test ./...' enumeration with a step that detects the project's actual test command (e.g., from package.json / Cargo.toml / pyproject.toml), making the verification step fully executable.

Add a brief conflict-handling branch to Option 1 (what to do when 'git merge <feature-branch>' reports conflicts), since merge conflicts are the most likely mid-step failure mode.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no explanation of concepts Claude already knows — every step is a command, an exact script, or a rule. Minor trimming is possible: the 'Common Mistakes' and 'Red Flags' sections restate the same rules (never proceed on failing tests, never delete without confirmation), placing this just below the fully-lean anchor.

4 / 5

Actionability

Guidance is mostly executable: concrete bash blocks for each option, exact user-facing scripts to present, and a complete 'gh pr create' heredoc. Minor gaps remain — the test step is an enumeration ('npm test / cargo test / pytest / go test ./...') and '<test command>' is a placeholder, so it is not fully copy-paste ready across contexts.

4 / 5

Workflow Clarity

A clear five-step sequence with explicit validation checkpoints and feedback loops: tests gate presenting options ("Stop. Don't proceed to Step 2"), the merged result is re-verified before branch deletion, and destructive Option 4 requires typed 'discard' confirmation and waits for exact confirmation. This matches the top anchor including error-recovery handling.

5 / 5

Progressive Disclosure

The skill is a single self-contained process with well-organized sections and a useful quick-reference table; no bundle files exist and none are needed, so there is no nested-reference or buried-content problem. It falls short of a 5 only because the redundant Common Mistakes/Red Flags/Quick Reference material could be consolidated more tightly.

4 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'Use when' trigger with concrete conditions, third-person voice, and a clear statement of what the skill does with specific integration options. Keyword coverage and scope breadth are good but not exhaustive.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "presenting structured options for merge, PR, or cleanup" — matching the anchor for several specific actions with minor gaps. It falls short of a 5 because it omits other capabilities the skill performs (test verification, worktree cleanup, branch deletion) and is not 3 since it goes beyond 1-2 generic actions.

4 / 5

Completeness

It explicitly answers both questions: an explicit trigger clause "Use when implementation is complete, all tests pass, and you need to decide how to integrate the work" and a clear what — "guides completion of development work by presenting structured options for merge, PR, or cleanup". Both are concrete, matching the top anchor rather than the 4 anchor whose 'when' is less specific.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "implementation is complete", "all tests pass", "integrate the work", "merge", "PR", "cleanup". A few natural terms are missing (e.g., "pull request" spelled out, "finish/close out the branch"), so it sits at good-but-not-comprehensive keyword coverage rather than a 5.

4 / 5

Distinctiveness Conflict Risk

The niche (deciding how to integrate completed development work) is well-delineated by its end-of-development trigger, but there is minor overlap risk with closely related skills such as dedicated PR-creation or git-worktree skills, matching the 'mostly distinct' anchor rather than the clear-niche anchor at 5.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

valeriibeck-star/claude-skills

Path

skills/finishing-a-development-branch/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.