CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autopilot-pr-merge-worker

Drive ONE already selected open pull request in microsoft/apm to mergeable. Classifies copilot-pull-request-reviewer[bot] inline review, runs autopilot-pr-review-worker, folds (by default) every recommendation inside the PR's stated scope, pushes to the head branch or a superseding PR that preserves authorship via commit trailers, watches CI to green (`agent-merge` when that skill or `<agent_merge_state>` is present; otherwise `gh pr checks --watch`), and iterates under fixed caps until ready-to-merge, advisory-with-deferred, superseded, or blocked. Plan before any fold, push, or reviewer request. Never spawned by autopilot-pr-review-scheduler. That scheduler is advisory only. Invoke this skill by name when the caller asked to drive a PR to merge.

71

Quality

89%

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

The canonical home for this skill is autopilot-pr-merge-worker in microsoft/apm

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.

A well-structured orchestration contract: the SKILL.md body carries the loop skeleton, gates, caps, and disciplines while pushing per-phase detail into one-level-deep bundled files that all exist and are clearly indexed. Validation checkpoints and feedback loops are pervasive, which matters for a write-heavy skill; the only real cost is minor repetition and a few meta-sentences that could be trimmed.

DimensionReasoningScore

Conciseness

The body is dense, telegraphic, and operational ('Missing field -> stop', 'Caps exist to bound non-determinism; they are not targets') with almost no explanation of concepts Claude already knows. However, several rules are repeated (the never-spawned-by-scheduler point appears twice, and never-assign/never-request-reviewers is stated three-plus times) plus meta-noise like 'This SKILL.md is the natural-language module derived from a genesis design packet', which matches 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is fully executable: a copy-paste dependency probe shell snippet, exact lint commands ('uv run --extra dev ruff check src/ tests/' and 'ruff format --check src/ tests/'), 'gh pr checks --watch', verbatim activation-card and exit-receipt templates, and a concretely stated mutation-break procedure ('deleting the guard it protects and confirming the test fails without it, then restoring the guard'). Detailed per-phase procedure is delegated to specific bundled files by path.

5 / 5

Workflow Clarity

An explicit 0.P through X.8 phase sequence with hard validation gates throughout: plan-before-implement gate, fail-closed canonical-owner gate, lint-until-silent, schema validation of every completion return, and CI-observed-green with a recovery loop. Feedback loops are explicit (CI recovery cap 3, re-spawn ONCE on malformed return then mark blocked) and hard caps bound every iteration, matching the top anchor including the destructive/batch validation requirement.

5 / 5

Progressive Disclosure

The body is an orchestration-contract overview; bulk detail is split one level deep into seven assets, one reference, and one script, each hyperlinked, indexed in the 'Bundled assets' section, and load-signaled where timing matters ('load it when entering that phase' for mergeability-gate.md). Every referenced path was verified to exist on disk, and no reference chains deeper than one level, matching the top anchor.

5 / 5

Total

19

/

20

Passed

Description

85%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 highly specific, well-bounded description that clearly answers both what it does and when to invoke it, with strong negative boundaries against sibling skills. Its main weakness is trigger-term coverage: the core phrase 'drive a PR to merge' is natural, but most of the remaining vocabulary is internal fleet jargon rather than terms a caller would naturally say, and common synonyms are missing.

Suggestions

Broaden the trigger phrase with natural variations users would actually say, e.g. 'Use when asked to land a PR, get a PR green, or see a PR through review to merge' instead of only 'drive a PR to merge'.

Trim internal jargon from the description (terminal-state names like 'advisory-with-deferred', 'superseded', and the `<agent_merge_state>` conditional) — keep one negative boundary example and move the rest into the body where the audience is the executing agent.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: 'Classifies copilot-pull-request-reviewer[bot] inline review', 'folds (by default) every recommendation inside the PR's stated scope', 'pushes to the head branch or a superseding PR that preserves authorship via commit trailers', and 'watches CI to green (`agent-merge` ... otherwise `gh pr checks --watch`)'. No meaningful action coverage gaps, matching the comprehensive anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

Both halves are explicit: the 'what' enumerates concrete actions through four named terminal states, and the 'when' is a concrete trigger clause ('when the caller asked to drive a PR to merge'). An explicit invoke-when clause is present, so the missing-trigger cap does not apply, and the when-clause is concrete rather than vague, matching the top anchor.

5 / 5

Trigger Term Quality

The natural trigger phrase 'drive a PR to merge' is present ('Invoke this skill by name when the caller asked to drive a PR to merge') along with 'pull request' and 'CI', but the remaining keyword surface is fleet-internal jargon ('advisory-with-deferred', 'superseded', scheduler names, `<agent_merge_state>`) rather than natural user variations like 'land the PR' or 'get CI green'. This matches 'some relevant keywords but missing common variations or synonyms' rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

The description is repo-scoped ('microsoft/apm'), names its sibling skills, and states explicit negative boundaries ('Never spawned by autopilot-pr-review-scheduler. That scheduler is advisory only.'). This gives it a clear niche with minimal conflict risk, matching the top anchor.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

microsoft/apm

Path

packages/autopilot/autopilot-pr-merge-worker/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.