CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

merge-risk

Use when assessing the risk of merging a PR

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/merge-risk/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a tight, highly executable instruction set: an exact output template, concrete per-category criteria with real-world examples, and a fully specified numeric scoring procedure with thresholds. It respects token budget, assumes Claude's competence, and is well organized for a single-file skill with no external references needed.

DimensionReasoningScore

Conciseness

The body is lean: a copy-ready output template, terse category definitions, and an exact numeric scoring spec, with almost every token earning its place. The one minor instance of over-explanation is 'You can walk back through two-way doors, but not one-way doors' — a concept Claude already knows, though it is brief and immediately operationalized. Not 5 because that sentence and 'Consider all possibilities' could be trimmed without losing clarity; not 3 because there is no padded or unnecessary section.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: an exact output format template, five named categories with explicit verdict scales, concrete examples of sensitive areas ('auth, permissions, payments, PII, secrets, data migrations, dependency bumps'), and a closed-form scoring procedure (verdict-to-number mapping, explicit weights, Σ(score × weight) / Σ(weights), and low/medium/high thresholds). Claude can execute this without inventing anything, and the instruction to keep the numerical score internal removes a real ambiguity.

5 / 5

Workflow Clarity

This is a single-task skill and the action is unambiguous: inspect the PR against each category, apply verdicts, compute the weighted score via the given formula and thresholds, and render the specified output format. The rubric's simple-skill exception applies (single action, unambiguous), and no destructive/batch operation cap is triggered since this is a read-only assessment. Not 4 because nothing in the sequence is left implicit — the format, scale, formula, and thresholds are all fully specified.

5 / 5

Progressive Disclosure

The skill is a single ~46-line file with no references/, scripts/, or assets/ directories, and it needs none — all content fits comfortably in SKILL.md. Per the rubric guideline ('For skills under 50 lines with no need for external references, progressive disclosure can score 5 with just well-organized sections'), the body's clear sections (output format → categories → scoring) earn the full score.

5 / 5

Total

19

/

20

Passed

Description

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

The description has a clear, natural trigger phrase and a reasonably distinct niche, but it under-communicates what the skill actually does. It names the task ('assess merge risk of a PR') without mentioning any of the concrete mechanics (five risk categories, per-category verdicts, weighted low/medium/high score), leaving both specificity and completeness in the weak-to-middling range.

Suggestions

State the concrete 'what': e.g. 'Evaluates a PR across five risk categories (alignment, impact, verification, rollback cost, error detection) and produces a weighted low/medium/high merge-risk verdict with a per-category gap report.'

Add natural trigger variations such as 'should I merge this', 'pre-merge review', or 'is this PR safe to merge' so the skill surfaces for a wider range of user phrasings.

Mention the output artifact (a per-category verdict list with risk gaps) so users know what they will get, not just when to invoke it.

DimensionReasoningScore

Specificity

The description names the domain ('merging a PR') but offers only one generic action ('assessing the risk') with no concrete capabilities such as the risk categories, verdict system, or weighted scoring the skill actually performs. This matches the anchor 'Names the domain but actions are minimal or generic' ('Processes PDF files'), and is below level 3 because no 1-2 concrete actions are enumerated.

2 / 5

Completeness

The 'when' is explicit ('Use when assessing the risk of merging a PR') but the 'what' is only weakly implied by the gerund 'assessing the risk' — the actual deliverable (a low/medium/high merge-risk verdict across named categories with weighted verdicts) is not stated. This sits between anchor 2 (only 'when' present, no 'what') and anchor 4 (both present, 'when' could be more explicit): the what is more than nothing but not concrete, so 3 fits best; it is not 4 because the 'what' half is vague, and not 2 because the task being performed is at least named.

3 / 5

Trigger Term Quality

Natural terms like 'Use when', 'merging', 'risk', and 'PR' are present and would plausibly appear in a user request ('assess the merge risk of this PR'). However, common variations are missing — 'pull request' is never spelled out, and related phrasings like 'should I merge this' or 'code review risk' are absent, matching the anchor 'Some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

'Assessing the risk of merging a PR' carves out a fairly distinct niche (pre-merge risk assessment) with minimal overlap risk against most skills. It is not 5 because it could softly overlap with generic code-review skills that also evaluate PRs for merge readiness, i.e. 'minor overlap risk with closely related skills'.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

warpdotdev/common-skills

Path

.agents/skills/merge-risk/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.