CtrlK
BlogDocsLog inGet started
Tessl Logo

prep-pr

Use when preparing the current branch for a pull request — resolving the base branch, checking changesets, running builds and reviews, filing findings as issues, and opening the PR with the mandatory five-section body.

70

Quality

86%

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.

An exceptionally actionable, well-sequenced operational skill: every step has executable commands, templates, and validation checks, and the bundle is genuinely used to keep the main file focused. The costs are length — several rhetorical justification passages could be trimmed or externalized — and a two-level reference chain for two of the five bundle files.

Suggestions

Trim or relocate the narrative rationale passages (the comment-delta origin story and measured-incident case studies, the retro justification) into a reference file or a short 'why' note, keeping only the operational rule and the one-line failure mode in SKILL.md.

Reference `references/wikilink-check.md` and `references/registering-a-stack.md` directly from the relevant steps (Step 7 and Step 9) so every bundle file is one hop from SKILL.md instead of two.

The 'Two traps in reading the number' subsection in Step 5 is self-contained background; moving it next to the comment-delta recipe would shorten a step that is explicitly marked as not a gate.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious project rules and never explains concepts Claude already knows, but it carries several narrative justification passages that could be tightened — e.g. the comment-delta backstory ("It exists because... nobody had been measuring it", the measured +66 incident) and the retro rationale ("dies with a remote container... looking complete and answering nothing"). This matches the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened"); it is above 2 because nothing is generic padding, and below 4 because multiple paragraphs of war-story rationale exceed what executing the steps requires.

3 / 5

Actionability

Guidance is copy-paste ready throughout: the verbatim PR-body heredoc, exact bash probes (`git config --get branch.$(git branch --show-current).gh-merge-base`), named authority scripts (`scripts/validate-changesets.sh`, `scripts/changeset-required.sh`), the full five-section body template with tables, and the final `grep -c` shape check. It matches the 5 anchor (fully executable commands covering the common cases) with no gaps.

5 / 5

Workflow Clarity

Steps 0–10 are explicitly sequenced with validation checkpoints and feedback loops: the up-front environment probe, the "write the skeleton before Step 0" rule, the grep count check that must print 5, re-running steps 3 and 4 after user fixes, and per-gate "not run" recording. This matches the 5 anchor (clear sequence, explicit validation, error-recovery loops) — the destructive/batch cap does not apply since validation is pervasive.

5 / 5

Progressive Disclosure

Structure is good: `references/workflow-steps.md` (115 lines) is lifted out with a stated reason ("to hold it under the token budget"), and `auditing-defect-classes.md` and `issue-filing-example.md` are clearly signaled with what they contain; all referenced files exist. It falls short of the 5 anchor because two bundle files (`wikilink-check.md`, `registering-a-stack.md`) are only reachable through workflow-steps.md — a second hop from SKILL.md — and some inline narrative (e.g. the comment-delta traps) could itself live in a reference.

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.

A strong description: explicit third-person "Use when" trigger plus a comprehensive, concrete enumeration of the workflow's actions. The only weakness is modest trigger-term variation — it covers "pull request"/"PR" but not synonyms a user might naturally say.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "resolving the base branch, checking changesets, running builds and reviews, filing findings as issues, and opening the PR with the mandatory five-section body" — giving comprehensive coverage of the skill's capabilities. It fits the 5 anchor ("multiple specific concrete actions; comprehensive coverage") and not 4, since there are no meaningful gaps in what the skill does.

5 / 5

Completeness

It explicitly answers "when" with a leading "Use when preparing the current branch for a pull request" and "what" with a five-action enumeration, matching the 5 anchor (both answered explicitly with concrete triggers). Not 4, because the when-clause is a concrete, natural trigger rather than a vague or weakly implied one.

5 / 5

Trigger Term Quality

"preparing the current branch for a pull request", "pull request", and "PR" are natural phrases a user would say, but common variations like "open a PR", "create a pull request", or "get this branch ready to merge" are absent. This matches the 4 anchor ("good keyword coverage; a few natural terms missing") rather than 5, which requires synonyms and fuller variation coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — branch-to-PR preparation with changesets, issue filing, and a mandated five-section body — is distinct with its own triggers; no generic skill would collide with it. Minor theoretical overlap with a bare "create a PR" skill is not enough to drop to the 4 anchor, which requires identifiable closely-related skills.

5 / 5

Total

19

/

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (527 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

14

/

16

Passed

Repository
englishstventures/osn
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.