CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-green-sweep

Review green pull requests, resolve review threads with current-head evidence, merge authorized PRs, and reconcile local branches. Use when the user requests PR closeout, scoped GitHub, CodeRabbit, Codex, or CI finding repairs, or until-green monitoring.

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 body is an operationally dense, validation-obsessed workflow with real commands, a precise blocker taxonomy, and a bundle whose referenced files and anchors all resolve. Its weaknesses are redundancy — the guardrail rule and reference citations repeat — and a two-level capsule routing chain that works against otherwise clean progressive disclosure.

Suggestions

State the recurring-finding guardrail rule (three-task recurrence threshold, durable control, non-merge-eligible) once — in Workflow step 8 — and cross-reference it from Execution Boundaries and the Failure Mode section instead of restating it three times.

Drop the trailing References section's re-citations of review-findings.md and closeout-commander.md that already appear inline where used, keeping only the entries (manifest, routing, eval fixtures, ledger schema) not linked earlier in the body.

Flatten the capsule chain: inline the routing table from knowledge-capsule-routing.md (or fold it into closeout-commander.md sections) so capsule selection is one reference hop instead of SKILL.md → routing file → capsule file.

DimensionReasoningScore

Conciseness

There is no concept padding or explanation of things Claude already knows — every line carries operational rules, matching the efficient anchors. It falls short of 5 because content repeats: the recurring-finding guardrail rule appears in Workflow step 8, Execution Boundaries, and the Failure Mode repair loop, and the trailing References section re-cites review-findings.md and closeout-commander.md already linked inline three to four times.

4 / 5

Actionability

Key gates have concrete, executable commands — `codex review --uncommitted`, `python3 Infrastructure/scripts/validation-and-linting/validate_pr_sweep_dirty_closeout.py --json --require-clean`, `scripts/validate_recurring_findings.py` — plus a precise blocker taxonomy with defined semantics. Not 5 because many workflow steps ('refresh the full PR URL... branch protection, review threads, required checks...') state what to verify without the commands, deferring specifics to reference files.

4 / 5

Workflow Clarity

The 16-step workflow is clearly sequenced with explicit validation checkpoints at every rung ('Before editing, after every push, before merge, before cleanup'), a fail-fast rule, and a full feedback loop ('classify the owner, name the next safe action, apply the recurrence threshold... then rerun only the gate that proves that owner class'). Not 4: validation is pervasive and error recovery is spelled out, not merely present with minor gaps.

5 / 5

Progressive Disclosure

The body is a structured overview with well-signaled, verified one-level references (review-findings.md, closeout-commander.md with anchors that resolve, scripts/validate_recurring_findings.py all exist). It is not 5 because the capsule chain — SKILL.md → knowledge-capsule-routing.md → knowledge-capsules/*.md (also routed via manifest and contract.yaml) — is two-plus levels deep, and dense mode rules and eval-fixture routing (evals.yaml, contract.yaml, task-profile.json) sit inline in SKILL.md rather than in a referenced file.

4 / 5

Total

17

/

20

Passed

Description

92%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 is strong: it enumerates concrete capabilities in third person and pairs them with an explicit, trigger-rich 'Use when' clause. Its only weakness is trigger phrasing that leans on internal jargon ('until-green monitoring', 'scoped GitHub') instead of the plain phrases a user would naturally say.

DimensionReasoningScore

Specificity

The description lists four concrete actions covering the skill's full lifecycle — "Review green pull requests, resolve review threads with current-head evidence, merge authorized PRs, and reconcile local branches" — matching the anchor for multiple specific concrete actions with comprehensive coverage. It is not 4 because there are no minor gaps: each enumerated action maps to a distinct skill capability.

5 / 5

Completeness

It explicitly answers both questions: a clear 'what' (review green PRs, resolve threads with current-head evidence, merge authorized PRs, reconcile local branches) and a concrete 'Use when the user requests PR closeout, scoped GitHub, CodeRabbit, Codex, or CI finding repairs, or until-green monitoring' trigger clause. Not 4, because the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

It includes good natural trigger terms users would say — "PR closeout", "CI finding repairs", "CodeRabbit", "Codex", "GitHub" — but coined phrases like "until-green monitoring" and "scoped GitHub" crowd out common phrasings such as "merge my PRs" or "get the checks green". This matches the anchor 'Good keyword coverage; a few natural terms missing' rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — PR closeout with merge authorization and branch reconciliation — with tool-specific triggers (CodeRabbit, Codex, CI) that no generic review or git skill would claim. Not 4, because overlap risk with closely related skills is minimal given the distinctive closeout/merge-proof framing.

5 / 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

jscraik/Agent-Skills

Path

Skills/agent-ops/pr-green-sweep/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.