CtrlK
BlogDocsLog inGet started
Tessl Logo

pr-finalize

Finalizes any PR for merge by verifying title/description match implementation AND performing code review for best practices. Use when asked to "finalize PR", "check PR description", "review commit message", before merging any PR, or when PR implementation changed during review. Do NOT use for extracting lessons (use learn-from-pr), writing tests (use write-tests-agent), or investigating build failures (use azdo-build-investigator and ci-analysis).

68

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable, well-structured skill body with concrete commands, decision checkpoints, and complete output templates for a two-phase workflow. Its main weakness is token efficiency: the critical no-posting rules are duplicated in full and the output templates inflate the main file, which also limits progressive disclosure.

Suggestions

Deduplicate the 'CRITICAL: Do NOT Post Comments' section: state the rule once in the top-level CRITICAL RULES and reference it from Phase 2 instead of repeating the full table and workflow.

Move the full rewrite output template and the 'Quality Comparison Examples' worked examples into references (e.g. references/output-templates.md), keeping only a skeleton inline in SKILL.md.

Fold the 'Two-Phase Workflow' section into the opening paragraph and surface the 'write to pr-finalize-summary.md' step inside the Output Format section so the stated workflow matches the documented output.

DimensionReasoningScore

Conciseness

Most sections (tables, title formula, output templates) earn their tokens, but the 'CRITICAL: Do NOT Post Comments' section is duplicated nearly verbatim (once in the opening rules, again in Phase 2), and the 'Two-Phase Workflow' intro restates the opening paragraph. This fits anchor 3 ('mostly efficient but could be tightened'); it is not anchor 2 because the verbosity is localized duplication rather than pervasive padding.

3 / 5

Actionability

Copy-paste-ready gh commands (gh pr view/diff with --json/--jq variants), a concrete title formula with good/bad examples, complete markdown output templates for both the keep and rewrite paths, and worked good/poor description examples. Matches anchor 5: fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Two phases are clearly sequenced and Phase 1 has an explicit decision checkpoint ('Is the existing description better than what my template would produce?') with keep/rewrite branches. Not anchor 5 because the 'write to pr-finalize-summary.md' step appears only in workflow prose and not in the output format, and Phase 2 (code review) has no corresponding checkpoint; not anchor 3 since checkpoints are explicit rather than missing.

4 / 5

Progressive Disclosure

The single reference (references/complete-example.md, verified to exist, 63 lines, well-structured) is clearly signaled exactly once and is one level deep; the body has clear section headers. Not anchor 5 because a sizable chunk of detail (output templates and worked quality-comparison examples) is inlined in SKILL.md where a second reference file could carry it.

4 / 5

Total

16

/

20

Passed

Description

91%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: concrete two-phase capability statement, explicit 'Use when' triggers in natural user language, and unusual negative-trigger disambiguation against sibling skills. The only weakness is moderate overlap risk with generic code-review/PR-review requests via the 'performing code review' and 'before merging' phrasing.

DimensionReasoningScore

Specificity

Names the domain and two concrete actions ('verifying title/description match implementation' and 'performing code review for best practices') covering both phases. Falls short of anchor 5, whose example enumerates four specific actions, but exceeds anchor 3's '1-2 concrete actions, not comprehensive' since both workflow phases are explicitly covered.

4 / 5

Completeness

Explicitly answers 'what' (verify title/description match, perform code review) and 'when' (a full 'Use when asked to...' clause with concrete trigger phrases), plus negative triggers. This matches anchor 5's pattern of what + when with concrete trigger phrases; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Quoted phrases 'finalize PR', 'check PR description', 'review commit message', 'before merging any PR', and 'when PR implementation changed during review' are natural user utterances with multiple variations, exceeding the good-keyword-coverage of anchor 4. All are phrases a user would plausibly say verbatim when wanting this skill.

5 / 5

Distinctiveness Conflict Risk

The 'Do NOT use for... (use learn-from-pr, write-tests-agent, azdo-build-investigator, ci-analysis)' clause provides strong disambiguation, but 'performing code review' and 'before merging any PR' could still capture generic PR-review requests intended for a plain code-review skill. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills') fits better than 5's 'minimal conflict risk'.

4 / 5

Total

18

/

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
dotnet/maui
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.