CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chained-pr

Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 lean, well-structured instruction skill: hard rules and decision gates are unambiguous, the workflow has explicit verification and error-recovery loops, and detail is correctly pushed to a single one-level-deep reference file. The only trimmable content is slight overlap between the Hard Rules and Decision Gates on the 400-line and size:exception paths.

DimensionReasoningScore

Conciseness

The body is dense and rule-driven with zero padding or explanation of concepts Claude already knows — every line carries a hard rule, gate, or step. Minor redundancy (the 400-line condition appears in both Hard Rules and the Decision Gates table, and the size:exception path is covered twice) keeps it just below the 'every token earns its place' anchor of 5.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact thresholds ("400 changed lines", "≤60 minutes"), specific mechanics ("draft/no-merge tracker PR", "dependency diagram marking the current PR with 📍"), and a sequenced 6-step execution plan, with actual commands delegated to references/chaining-details.md. It stops short of fully copy-paste-ready commands in the body itself, so it fits 'mostly executable guidance with minor gaps' rather than a 5.

4 / 5

Workflow Clarity

The Execution Steps give a clear sequence with an explicit validation step ("Verify each PR independently: CI/tests/docs/manual checks, rollback scope, and clean diff"), a validate-fix-retry feedback loop ("Treat polluted diffs as base bugs: retarget or rebase until only the current work unit appears"), and the Decision Gates table acts as a condition-action checklist. This matches the anchor for explicit validation, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

The ~44-line body is a well-organized overview (Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References) with a single clearly signaled reference — [references/chaining-details.md](references/chaining-details.md) — annotated with what it contains. The referenced file exists, is one level deep (no nested .md links inside), and holds the appropriately deferred details (strategy diagrams, PR body section, branch commands, reviewer guidance).

5 / 5

Total

18

/

20

Passed

Description

82%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 terse, third-person description that explicitly answers both what the skill does and when to load it, using natural trigger phrases like 'stacked PRs' and 'PRs over 400 lines'. Its only weakness is thin action coverage — it names a single capability rather than enumerating several.

DimensionReasoningScore

Specificity

The description names the domain ("PRs over 400 lines") and one concrete action ("Split oversized changes into chained PRs that protect review focus"), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not generic enough for a 2, but lists only a single action, so it does not reach the several-actions anchors of 4 or 5.

3 / 5

Completeness

Both halves are explicit: the what is "Split oversized changes into chained PRs that protect review focus", and the when is the explicit trigger clause "Trigger: PRs over 400 lines, stacked PRs, review slices" with concrete trigger phrases. This matches the anchor that clearly answers both what and when; it is well above the 'when could be more explicit' level of a 4.

5 / 5

Trigger Term Quality

"PRs over 400 lines, stacked PRs, review slices" includes the canonical natural phrases a user would say ("stacked PRs", "PRs over 400 lines"), giving good keyword coverage. It misses common variations such as "large/big PR", "pull request size", or "review load", so it falls short of the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

"chained PRs", "stacked PRs", and the 400-line threshold carve out a clear niche (PR splitting for review-load control) with distinct triggers and minimal conflict risk against other skills. It is far more targeted than the 'minor overlap risk with closely related skills' anchor at 4.

5 / 5

Total

17

/

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

Gentleman-Programming/gentle-ai

Path

internal/assets/skills/chained-pr/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.