CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prp-pr

Creates and opens GitHub pull requests. Always use when creating a PR on GitHub, when the user explicitly asks to create or open a PR, when another PRP workflow reaches its PR-creation step, or when the user invokes $prp-pr.

Quality

90%

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

92%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 excellent instruction-only skill body: lean, non-obvious, opinionated guidance organized into a clearly sequenced workflow with strong validation checkpoints and error-recovery stop conditions. The only improvement would be showing the complete `gh pr create` command (e.g. with --base, --title, --body flags) to close the last actionability gap.

DimensionReasoningScore

Conciseness

The body is lean, imperative, and assumes Claude's competence throughout — it never explains what a PR or git is, and every instruction adds non-obvious policy ("Never assume main", "do not rebase or force-push as part of this skill"). The only near-redundancy is the duplicated "$ARGUMENTS" note, which is trivial; this matches the 'every token earns its place' anchor.

5 / 5

Actionability

Guidance is highly concrete: an ordered base-resolution procedure, an exact fallback PR body template in a copy-paste markdown block, explicit flag rules ("--base <branch>", "Use --draft only when the user explicitly requests a draft"), and concrete bad/good title examples. Not a 5 because the actual `gh pr create` invocation is described but never shown as a complete command line, leaving a minor gap for the single most important execution step.

4 / 5

Workflow Clarity

Five clearly sequenced sections (establish target → validate work → write PR → push and create → verify and report) with explicit validation checkpoints: re-reading the merge-base diff, comparing against the requested outcome, checking for existing PRs, and verifying the created PR's number/base/head before reporting success. Stop-and-ask and stop-and-report error paths cover recovery, matching the top anchor including feedback loops.

5 / 5

Progressive Disclosure

This is a single-file skill with no references/, scripts/, or assets/ bundle; nothing needs to be split out, sections are well-organized with a clear hierarchy (Scope → numbered steps → Title/Description subsections), and there are no nested or dead references. Per the rubric's guidance to score against the actual bundle structure, a self-contained skill with well-organized sections warrants the top score.

5 / 5

Total

19

/

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 strong description with an explicit and multi-condition trigger clause, clear what/when structure, and a distinctive niche. Its only weakness is capability breadth: the 'what' states a single action pair rather than enumerating the concrete sub-capabilities (title/body writing, base resolution, validation, reporting) the skill performs.

Suggestions

Expand the 'what' clause to name 2-3 more concrete capabilities, e.g. 'Creates and opens GitHub pull requests: resolves the base branch, writes reviewer-friendly titles and descriptions from the repository template, validates the diff, and verifies the created PR.'

Add a few natural trigger synonyms such as 'submit a PR' or 'open a pull request' to broaden keyword coverage beyond 'create or open a PR'.

Clarify 'another PRP workflow' for readers outside that ecosystem, since it assumes prior context to interpret correctly.

DimensionReasoningScore

Specificity

"Creates and opens GitHub pull requests" names the domain and one core action pair, but does not list the several specific capabilities the skill actually performs (title/body authoring, base resolution, validation, CI checks), matching the '1-2 concrete actions, not comprehensive' anchor. It is not a 4 because no enumeration of several specific actions appears, and not a 2 because the action named is concrete rather than generic.

3 / 5

Completeness

It clearly answers 'what' ("Creates and opens GitHub pull requests") and 'when' with an explicit "Always use when" clause listing four concrete trigger conditions. Not a 4 because the 'when' is fully explicit with multiple concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say — "creating a PR on GitHub", "create or open a PR" — plus the explicit "$prp-pr" invocation, giving good keyword coverage. Not a 5 because common synonyms like "submit a PR", "open a pull request", or "draft PR" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (GitHub PR creation) is clear and the triggers — including the unique "$prp-pr" invocation and the PRP-workflow step — are distinct, so conflict with other skills is minimal. Not a 4 because nothing about the description broadly overlaps neighboring skills like commit-message or PR-review skills.

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

Wirasm/prp

Path

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