CtrlK
BlogDocsLog inGet started
Tessl Logo

finishing-a-development-branch

Use when the user wants to finish a development branch or asks what to do with finished work (merge it, push it and open a pull request, keep it for later, throw it away, or remove its worktree), and before any merge, push, branch deletion or worktree removal at the end of a piece of work. Runs the tests first, presents the options as the user's decision, and never destroys unmerged commits or uncommitted files without explicit confirmation.

75

Quality

92%

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

The canonical home for this skill is tessleng/sdlc-assurance

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 well-engineered operational skill: an explicitly sequenced six-step workflow with genuine validation checkpoints and feedback loops around its destructive paths, fully executable commands, and exact interaction scripts. It is only held back from perfection by light redundancy between the steps and the rationalizations table, and by keeping everything — including supplementary material — inline in one file.

DimensionReasoningScore

Conciseness

The body is dense with commands, exact menu text, and decision tables rather than concept explanations, but has minor trimmable redundancy: the MAIN_ROOT computation and cd appear twice (Option 1 and the discard path), and the 'Common Rationalizations' table restates safety rules already given in Steps 4–6. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Nearly everything is copy-paste-ready bash (environment detection, merge sequence, worktree removal, status --porcelain -uall), exact literal menu prompts, and an exact typed-'discard' confirmation protocol; placeholders (<feature-branch>, <base-branch>) are appropriate, and the one flexible step (PR creation 'with the forge's tooling — its CLI if one is available, or the creation URL most forges print') explicitly justifies its flexibility across forges.

5 / 5

Workflow Clarity

The core principle line states the sequence (Verify tests → Detect environment → Present options → Execute choice → Clean up), each step is numbered with explicit validation: tests must pass before the menu, the merged result is re-tested with a stop-and-investigate path, worktree removal refusal triggers a show-files-and-ask feedback loop, and deletion requires a typed 'discard'. This is exactly the clear-sequence-with-explicit-validation-and-feedback-loops anchor, which matters for a skill with destructive operations.

5 / 5

Progressive Disclosure

No bundle files exist and the body references none, so all content is appropriately self-contained with well-organized sections, tables, and a Quick Reference; however, at ~220 lines it is a single-file monolith whose 'Common Rationalizations' table (10 rows) is the kind of supplementary material that could live in a one-level-deep reference file, leaving minor organization gaps versus the clean split/navigation of anchor 5.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: explicit 'Use when' triggers phrased in natural user language, a complete enumeration of the concrete options the skill manages, and behavioral guarantees that delimit safe operation. Its only weakness is slight breadth — the push/PR and worktree-removal scope and the 'before any merge, push' trigger give it minor overlap with adjacent git skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "merge it, push it and open a pull request, keep it for later, throw it away, or remove its worktree" — plus concrete behaviors ("Runs the tests first", "never destroys unmerged commits or uncommitted files without explicit confirmation"), giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Both 'what' and 'when' are explicit: it opens with "Use when the user wants to finish a development branch..." (when, with concrete trigger phrases) and states what it does (runs tests first, presents merge/push/keep/discard options as the user's decision, never destroys work without confirmation).

5 / 5

Trigger Term Quality

Trigger phrases are exactly what a user would say: "finish a development branch", "what to do with finished work", "keep it for later", "throw it away", "remove its worktree", plus preemptive triggers ("before any merge, push, branch deletion or worktree removal"). Synonym variations are covered (e.g., "throw it away" for discard).

5 / 5

Distinctiveness Conflict Risk

The end-of-work branch-finishing niche is clear and distinct ("finish a development branch", "what to do with finished work"), but the scope explicitly covers push/PR creation and worktree removal, creating minor overlap risk with dedicated PR-creation or git-worktree skills; the broad "before any merge, push" trigger could also fire in adjacent git workflows. This is 'mostly distinct; minor overlap' rather than the clear-niche anchor 5.

4 / 5

Total

19

/

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
tesslio/tessl-eval-demo
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.