CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr

Creates a pull request for the current branch.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/pr/SKILL.md
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.

This is a well-engineered instruction-only skill: a clearly sequenced five-phase workflow with real validation gates and feedback loops, concrete commands throughout, and a well-signaled external changelog reference. Its weaknesses are modest — some enforcement-oriented padding and a few under-specified invocations.

DimensionReasoningScore

Conciseness

The body is directive and assumes Claude's competence — no git or PR concepts are re-explained, and the triage categories and subagent prompts are dense with specifics. Minor trimming opportunities remain: enforcement padding like "MANDATORY — DO NOT SKIP. This phase must run before any PR is created, regardless of how 'simple', 'mechanical', or 'well-tested' the changes appear" and "Subtle bugs... hide in exactly the changes that seem safe to skip" is persuasive rather than instructional, and the prose-pass invocation is repeated three times. Efficient with minor over-explanation — anchor 4, not 5, where every token would earn its place.

4 / 5

Actionability

Guidance is mostly executable: exact commands ("git merge-base main HEAD", "gh pr list --head <parent-branch>", "gh pr edit <number> --add-label no-changelog"), precise commit messages ("docs: Update changelogs"), a first-match-wins triage table, and concrete subagent prompt scopes. Not a 5 because a few invocations are underspecified — "gh pr create" appears without flags/arguments (no --title/--body-file guidance) and "run the checks (`lint-build-test`)" assumes the reader resolves how to run them. Mostly executable guidance with minor gaps — anchor 4.

4 / 5

Workflow Clarity

Five phases are explicitly sequenced with validation checkpoints and genuine feedback loops: pre-flight gates ("If any of the following conditions apply, stop and report the errors"), a re-loop after the prose pass ("If it changes files, run the checks (`lint-build-test`), commit..., push, and re-run step 4"), a blocker decision tree in Phase 3 ("Fix the blockers automatically, then re-review" / "Proceed" / "Abort"), and a changelog branch decision in Phase 5. This matches anchor 5: clear sequence, explicit validation, and error-recovery feedback loops.

5 / 5

Progressive Disclosure

No bundle files exist, so all content lives in a single well-sectioned SKILL.md with clear phase headers, and the one external pointer ("Read the instructions in docs/contributing/updating-changelogs.md") is a clearly signaled one-level reference whose key points are also summarized inline. Not a 5 because the ~60 lines of four subagent prompt specifications are inlined and could be split into reference files to keep the overview lean, and the body exceeds a lean overview at ~140 lines. Good structure with minor organization gaps — anchor 4.

4 / 5

Total

17

/

20

Passed

Description

53%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 states a single concrete, distinct capability in appropriately concise third-person form, but it undersells what the skill actually does and omits any "when to use" trigger guidance. It sits just above the midpoint: clear and unambiguous, yet incomplete as a trigger surface.

Suggestions

Add an explicit trigger clause, e.g. "Use when asked to create/open a PR, submit a branch for review, or prepare a pull request with gh."

Mention the skill's other concrete capabilities (automated multi-agent diff review, stacked PR handling, changelog updates) so the description covers what the body actually does.

Include common synonyms such as "PR" and "draft PR" alongside "pull request" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Creates a pull request for the current branch" names the domain and one concrete action, but does not mention the skill's other capabilities (code review subagents, stacked PRs, changelog updates), matching the anchor for 1-2 concrete actions without comprehensive coverage. Not a 4 because only a single action is listed; not a 2 because the action is concrete and target-specific rather than generic.

3 / 5

Completeness

The "what" is clear ("Creates a pull request for the current branch") but there is no "Use when..." clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. Not a 4 because the "when" is entirely absent rather than just under-specified.

3 / 5

Trigger Term Quality

"pull request" is a natural keyword a user would say, but common variations are missing — the abbreviation "PR", "open a PR", "draft PR", or "gh pr" never appear. This matches the anchor for some relevant keywords but missing common variations or synonyms.

3 / 5

Distinctiveness Conflict Risk

"Creates a pull request for the current branch" carves out a clear, specific niche (PR creation) that would not trigger for unrelated skills, but without any "when" guidance it has minor overlap risk with closely related git-workflow or PR-review skills. Mostly distinct with minor overlap risk — anchor 4 rather than 5, whose example pairs a concrete "what" with explicit distinct triggers.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

Consensys-Incorporated/ocap-kernel

Path

.claude/skills/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.