CtrlK
BlogDocsLog inGet started
Tessl Logo

create-pr

Create a pull request with a clear, concise description that follows the repository's current PR template. Use when asked to open a PR or prepare its title and description.

71

Quality

89%

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

The canonical home for this skill is create-pr in ueberdosis/tiptap

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 well-structured, lean, actionable instruction-only skill with a clear sequenced workflow, explicit validation before publishing, and thoughtful failure handling (duplicate PRs, auth errors, unresolvable links). Remaining gains are small: tighten the duplicated template-freshness bullets and add the exact gh commands.

Suggestions

Merge the two overlapping bullets about preferring the live template over remembered/stale copies into a single rule to remove redundancy in the 'Read the current template' section.

Include the concrete commands for the creation safeguards, e.g. `gh pr list --head <branch>` for the existing-PR check and a full `gh pr create --title-file/--body-file` example, to close the last actionability gap.

The bug-fix bullet enumerates setup, repro, expected, and observed behavior — consider compacting it into a short labeled list format so it reads as a fill-in pattern rather than a long sentence.

DimensionReasoningScore

Conciseness

The body is dense, imperative guidance with no padding about concepts Claude already knows — every bullet instructs. Two bullets redundantly state the same template-freshness rule ('Do not copy its structure into this skill or reuse a remembered version' vs. 'Prefer the actual current PR template over stale copies of its structure in other guidance'), which is a minor trim, matching anchor 4 rather than the fully lean 5.

4 / 5

Actionability

Concrete, specific guidance throughout: template search paths ('repository root, .github/, and docs/'), a required field list for bug fixes (setup, repro steps, expected vs. observed), and exact mechanics ('write the exact Markdown to a temporary file and use --body-file'). It stops short of showing the actual `gh pr create` invocation and duplicate-check command, so it is 'mostly executable with minor gaps' rather than fully copy-paste ready.

4 / 5

Workflow Clarity

A clear four-phase sequence (read template → write description → link related work → create PR) with an explicit pre-publish checkpoint ('compare the finished description with every template section... Confirm that claims match the diff, links are accurate, and no placeholders remain') and error-recovery feedback loops ('If creation has an ambiguous result, check whether it succeeded before retrying to avoid duplicates. Report unresolved authentication or permission failures instead of repeatedly retrying'). This is not a destructive/batch operation, so no cap applies.

5 / 5

Progressive Disclosure

The body is under 50 lines with no external references needed and no references/scripts/assets bundle present; per the rubric's simple-skill guidance, well-organized sections (Read the current template, Write the description, Link related work, Create the PR) suffice for a 5.

5 / 5

Total

18

/

20

Passed

Description

87%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 what and when, third person, natural trigger phrasing, and a well-defined niche. Only minor room to grow via broader synonym coverage and slightly fuller action enumeration.

DimensionReasoningScore

Specificity

Concrete actions are named — 'Create a pull request with a clear, concise description that follows the repository's current PR template' plus preparing 'its title and description' — in third person. It lists several specific actions but leaves minor gaps (e.g., draft vs. ready PR, publishing behavior), so it sits between the 3 and 5 anchors, closer to 'several specific actions; minor gaps'.

4 / 5

Completeness

It explicitly answers both questions: what ('Create a pull request with a clear, concise description that follows the repository's current PR template') and when ('Use when asked to open a PR or prepare its title and description') with concrete trigger phrases, matching the anchor 5 example structure exactly.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'open a PR', 'pull request', 'PR', 'title and description'. A few natural variants are missing ('merge request', 'draft PR', 'write the PR body'), matching the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The PR-creation niche is clear with distinct triggers ('open a PR', 'PR template', 'prepare its title and description'), so risk of firing for unrelated skills (e.g., commit-message writing) is minimal — the anchor 5 case.

5 / 5

Total

18

/

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
ueberdosis/tiptap
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.