CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-finish-branch

Wrap up a branch — run tests, create PR, merge or discard — use when implementation is done

56

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/skill-finish-branch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 genuinely actionable skill with strong safety gates (test-first, typed destructive confirmation, guarded PR creation) undermined by structural defects: duplicated step numbering, contradictory option numbering between the presentation and execution sections, an unterminated shell quote, and triple-redundant safety tables. It works as a single-file monolith but is over the size where inlining everything is efficient.

Suggestions

Fix the sequence defects: renumber the duplicated steps (two 'Step 4' and two 'Step 5' headers) and reconcile the option numbering so 'Present Options' and 'Execute Choice' agree on whether Create PR is option 1 or 2 — the current mismatch makes a user's 'option 1' ambiguous between merge and PR.

Close the unterminated quote in the Step 2 orchestrate.sh invocation and make the changelog step executable (an actual prepend command or heredoc) instead of a bare comment.

Collapse 'Red Flags - Never Do', 'Common Mistakes', and 'The Bottom Line' into one table (they restate the same three rules), and move the Claude Octopus integration notes into a separate reference file to cut the body roughly by a third.

Ship or guard the external script dependencies (orchestrate.sh, safe-gh-comment.sh) — they are referenced with absolute home paths but not present in the bundle, so execution fails on machines without the octopus plugin installed.

DimensionReasoningScore

Conciseness

The body is command-first with essentially no explanation of concepts Claude already knows, but the same safety rules are restated three times ("Red Flags - Never Do", "Common Mistakes", "The Bottom Line"), and the "Integration with Claude Octopus" and "Quick Reference" table largely duplicate earlier content. That matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Most steps give concrete, executable bash (test-suite detection, merge sequence, push + guarded PR creation with a typed-confirmation discard flow). It stops short of 5 because Step 2's orchestrate.sh block has an unterminated quote (the embedded diff string never closes), Step 4's changelog step is only a comment ("Prepend to CHANGELOG.md if it exists"), and the octopus integration section is illustrative pseudo-flow rather than runnable code.

4 / 5

Workflow Clarity

The pipeline has strong validation checkpoints (tests must pass before proceeding, typed "discard" confirmation, re-test after merge, error-recovery guidance in the PR block), but the sequence is broken by structural errors: the step numbers repeat (two "Step 4" and two "Step 5" headers after Step 5), and "Step 5: Present Options" numbers Create PR as option 1 while "Execute Choice" and the Quick Reference table number Merge Locally as option 1 — so 'user chose option 1' is ambiguous between merge and PR in a workflow that includes destructive actions. This lands at 'steps listed but with gaps/implicit mapping' rather than 4, where the sequence would be reliably followable.

3 / 5

Progressive Disclosure

The skill is a single ~380-line file with no bundle (references/, scripts/, assets/ are absent), yet it references external scripts (${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh, safe-gh-comment.sh) that are not shipped in the bundle. Sections are well-labeled, but content that would naturally split out (the octopus integration notes, the option-by-option execution detail) is inlined in one monolithic file, matching 'some structure but could be better organized' rather than 4.

3 / 5

Total

13

/

20

Passed

Description

71%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 compact, third-person description that names its core actions and includes an explicit use-when clause, comfortably above the good-example bar for structure. Its weaknesses are a generic when-trigger ('implementation is done'), a trigger vocabulary missing common synonyms, and moderate overlap risk with general git-completion skills.

Suggestions

Make the when-clause concrete with trigger phrases users actually say, e.g. "Use when the user says 'wrap this up', 'ready to merge', 'create a PR', or asks to finish/push a branch".

Add missing natural synonyms ("ship", "push", "open a PR", "finish the feature") to the trigger vocabulary so the skill matches more phrasings users actually use.

Sharpen distinctiveness by signaling it is the full end-of-branch pipeline (verify tests, review, then merge/PR/discard by choice) rather than a plain commit helper.

DimensionReasoningScore

Specificity

"run tests, create PR, merge or discard" lists several concrete actions, matching the 'lists several specific actions; minor gaps' anchor. It falls short of 5 because the full pipeline (multi-provider review, version bump, changelog, worktree cleanup) is not represented, and short of 3 territory because multiple distinct actions are named rather than 1-2.

4 / 5

Completeness

Both halves are explicit: the what ("run tests, create PR, merge or discard") and the when ("use when implementation is done"). The when-clause is present but generic — it lacks concrete trigger phrases like 'use when the user says "ready to merge"' — so it sits at the anchor where 'when' could be more explicit rather than at 5.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "wrap up a branch", "create PR", "merge", "implementation is done". Not a 5 because common synonyms like "ship", "push", "finish the feature", or "open a PR" are missing, leaving a few natural terms uncovered.

4 / 5

Distinctiveness Conflict Risk

The branch-completion niche is somewhat specific, but the trigger "use when implementation is done" is broad enough to overlap with generic commit/push/release skills, matching 'somewhat specific but could still overlap with similar skills'. Not 4: the overlap risk is more than minor since nearly every git-workflow skill claims tests, commits, and PRs; not 2: it is clearly scoped to branch finishing, not merely 'helps with files'.

3 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nyldn/claude-octopus
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.