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

58

Quality

66%

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 ./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 largely action-oriented, executable workflow guide whose strengths are concrete commands and safety confirmations. It is held back by broken step numbering with a menu/option mismatch, padded guard sections, and a fully monolithic structure with no progressive disclosure despite an external-file reference that doesn't resolve.

Suggestions

Fix the step numbering — the body has two Step 4s and two Step 5s ('Step 5: Present Options' precedes 'Step 4: Execute Choice') — and align the menu's option numbers with the execution headings (menu says 1 = Create PR, but the section 'Option 1: Merge Locally').

Remove or merge the redundant sections (Execution Contract, Red Flags, Common Mistakes, The Bottom Line) — the rules they restate are already enforced at the point of use inline.

Either bundle the referenced host-adapter and option-specific details as real reference files (e.g., references/options.md) or delete the dangling 'skills/blocks/codex-host-adapter.md' pointer, since no such file ships with this skill.

DimensionReasoningScore

Conciseness

The body is mostly command-driven and terse, but contains padded sections that add little Claude doesn't already know: the 'Execution Contract (MANDATORY)' block, the 'Red Flags' and 'Common Mistakes' tables that restate rules already enforced inline, and the redundant 'The Bottom Line'. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the padding spans several sections, not minor instances.

3 / 5

Actionability

Most steps ship concrete, executable bash (test detection cascade, merge-base diff commands, worktree cleanup), matching 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because several spots are placeholders rather than runnable: 'npm test # or appropriate test command', '# Prepend to CHANGELOG.md if it exists', PR_TITLE/CHANGE_SUMMARY enforced with :? but never defined, and a fabricated PR URL 'https://github.com/owner/repo/pull/123'.

4 / 5

Workflow Clarity

Validation checkpoints exist where it matters (tests must pass before proceeding; typed 'discard' confirmation for deletion), so the destructive-operation cap isn't the binding issue — but the sequence itself is incoherent: 'Step 5: Present Options' is followed by a second 'Step 4: Execute Choice' and a second 'Step 5: Cleanup', and the presented menu numbers 'Create PR' as option 1 while the execution section labels 'Merge Locally' as Option 1. This fits 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' territory — specifically, the numbering collision and menu/option mismatch break the sequence's clarity.

3 / 5

Progressive Disclosure

The file is well-sectioned with headers and a Quick Reference table (some structure), but everything lives inline in one ~360-line SKILL.md with no bundle files: no references/, scripts/, or assets/ exist, and the one cited external path ('skills/blocks/codex-host-adapter.md') is not part of this bundle. That matches 'Some structure but could be better organized' rather than 4, since content like the four option walkthroughs and octopus integration could be split out, and there is no one-level-deep reference organization to reward.

3 / 5

Total

13

/

20

Passed

Description

75%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 pairs a concrete action list with an explicit 'use when' trigger, earning solid mid-high marks across all dimensions. Its main limitation is thin trigger coverage — one when-clause without synonyms — which caps completeness and trigger quality just below the top anchor.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "run tests, create PR, merge or discard" — matching the anchor 'Lists several specific actions; minor gaps in coverage'. It sits below a 5 because it omits other capabilities the skill actually performs (version bump, changelog update, worktree cleanup), and above a 3 because it goes well beyond naming the domain with 1-2 generic actions.

4 / 5

Completeness

Both parts are answered: what ("run tests, create PR, merge or discard") and an explicit when ("use when implementation is done"), matching 'Has both what and when; when could be more explicit or specific'. Not a 5 because the single when-clause lacks the concrete trigger variations the top anchor requires (e.g., 'when the user says they're done or asks for a PR'); clearly above 3 since the when-clause is explicit rather than merely implied.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "wrap up a branch", "run tests", "create PR", "merge", "discard", "implementation is done" — good keyword coverage per the anchor 'Good keyword coverage; a few natural terms missing'. Not a 5 because common synonyms like "ship", "open a PR", "close out", or "done with the branch" are absent, and not a 3 because the included terms are natural rather than jargon-only.

4 / 5

Distinctiveness Conflict Risk

The branch-completion framing ("Wrap up a branch", "merge or discard") carves a clear niche that is mostly distinct, matching 'Mostly distinct; minor overlap risk with closely related skills'. Not a 5 because a dedicated PR-creation or commit-message skill could plausibly fire on overlapping phrases like 'create PR'; well above 3 since the discard/merge framing is specific to this skill.

4 / 5

Total

16

/

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
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.