CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

contributor-setup

Bring a branch that predates next's agent rules up to date once, then fix the bodies of your open PRs into next. Use when the PR body check fails or when an agent opened a PR into next by hand.

Quality

91%

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

100%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 exemplary terse operational skill: copy-paste commands in every step, explicit validation gates and termination conditions throughout, no padding, and its one bundle script is real, correctly referenced, and behaves as described. No dimension shows a meaningful weakness.

DimensionReasoningScore

Conciseness

The 19-line body contains no concept explanations and every sentence carries repo-specific knowledge Claude cannot infer ("A PR into `next` gets its body from `node .agents/pstack/land.mjs`. An agent that writes the body itself runs on a branch older than `next`'s agent rules.") or direct instruction, matching anchor 5's lean-and-efficient standard.

5 / 5

Actionability

Every step ships a copy-paste-ready command (`git fetch <remote> next && git rev-list --count HEAD..<remote>/next -- AGENTS.md .agents .claude .codex`, the gh pr list/view/edit invocations, `node .agents/rules/contributor-setup/scripts/doctor.mjs`), and the doctor script was verified to print `fix:` lines and `ok:` as the body claims; the only delegation ("as the `plan-page` skill's PR section says, with `--into <file>`") is an explicitly signaled conditional branch, matching anchor 5.

5 / 5

Workflow Clarity

The four steps are clearly sequenced with explicit gates and feedback loops even though the operation is batch (multiple PRs): "When it prints more than 0 ... and stop here", "apply what it prints until it prints `ok:`", and "This step is done when step 3's command prints nothing", so the batch-operation cap does not apply and anchor 5 fits.

5 / 5

Progressive Disclosure

For an under-50-line skill the single-bundle-file structure is ideal: scripts/doctor.mjs exists in the bundle and is referenced exactly where needed via its repo path, and external pointers (`.agents/pstack/rules/land.md`, the `plan-page` skill) are one level deep and clearly signaled, matching the simple-skill anchor-5 case.

5 / 5

Total

20

/

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 highly specific, well-triggered description for a narrow repo workflow: it states concrete actions and gives two explicit, natural 'Use when' triggers with essentially no conflict risk. Its main deduction is the second-person "your open PRs" phrasing and limited synonym coverage.

Suggestions

Rewrite in third person to avoid the voice penalty: e.g. "fixes the bodies of the author's open PRs into next" instead of "fix the bodies of your open PRs into next".

Raise specificity by naming a third concrete action, such as applying the session-start plugin fixes via doctor.mjs, so the description covers the skill's full scope with 'several' actions.

Broaden trigger coverage with synonyms: spell out "pull request" at least once (e.g. "Use when the PR/pull-request body check fails") so users who don't say "PR" still match.

DimensionReasoningScore

Specificity

Two concrete, precisely scoped actions ("Bring a branch that predates next's agent rules up to date once", "fix the bodies of your open PRs into next") sit above anchor 3's generic 1-2 actions but short of anchor 4's 'several specific actions'; the second-person "your open PRs" triggers the rubric's -1 voice penalty, landing at 3.

3 / 5

Completeness

Explicitly answers both: what ("Bring a branch ... up to date once, then fix the bodies of your open PRs") and when ("Use when the PR body check fails or when an agent opened a PR into next by hand") with two concrete trigger phrases, matching anchor 5 rather than 4 since the 'when' needs no added specificity.

5 / 5

Trigger Term Quality

"PR body check fails" and "agent opened a PR into next" are natural phrases a user in this workflow would say, matching anchor 4's good-but-incomplete coverage; anchor 5 is not reached because synonyms like "pull request" (vs. only "PR") or "update branch" are absent.

4 / 5

Distinctiveness Conflict Risk

"next's agent rules", "PRs into next", and "PR body check" define a narrow repo-specific niche with distinct triggers and virtually no overlap risk with other skills, matching anchor 5.

5 / 5

Total

17

/

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

udecode/plate

Path

.agents/skills/contributor-setup/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.