CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-pr

Full PR/MR creation pipeline. VCS-aware (GitHub `gh` / GitLab `glab`), runs self-review + checks, and writes a structured description (TL;DR, change table, mermaid flow, honest verification status, no em-dashes). On GitLab it adapts the project's `.gitlab/merge_request_templates` template, filling its sections and appending only the extras it lacks. Opens as a draft when verification is incomplete.

Quality

83%

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 AndreJorgeLopes/devflow

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 strong, highly actionable skill body: concrete commands, a full body template, explicit decision rules (draft when unverified, never open with failing checks), and a well-sequenced workflow with approval gates and recovery loops. Only minor room to trim asides and optionally split the GitLab template logic into a reference file.

DimensionReasoningScore

Conciseness

The body is dense, project-specific, and assumes Claude's competence (no explanations of what a PR or Mermaid is), with every section carrying actionable rules. A few asides could be trimmed, e.g. "(Em-dashes read as machine-written and are a hard no)" and the parenthetical fallback notes in step 1, so it does not reach a 5.

4 / 5

Actionability

Fully executable guidance throughout: concrete commands (`git log --oneline main..HEAD`, `git remote get-url origin`, `gh pr create --title ... --body-file ...`, `glab mr create --description ... --target-branch ...`), a complete GitHub body template, explicit provider-detection glob rules, and copy-paste-ready draft logic covering the common cases.

5 / 5

Workflow Clarity

Steps 0-9 are clearly sequenced with explicit validation checkpoints and feedback loops: self-review, running checks, "report them and ask the user whether to fix first or proceed" before proceeding, presenting the draft for approval, and the step-0 recovery loop ("If it folds edits back... If it reports an ambiguous case, resolve it by hand"). The destructive/batch cap does not apply since push/create actions are gated behind checks and explicit approval.

5 / 5

Progressive Disclosure

Single-file skill (no references/, scripts/, or assets/ exist) with well-organized sections (Steps, Description rules, Provider assembly, Creating the PR/MR, Important) and only one-level references to repo files (CLAUDE.md, `lib/utils.sh`, `scripts/skills-guard.sh`), none nested. Minor gap: the detailed GitLab template-adaptation procedure could live in a separate reference file to slim the main body.

4 / 5

Total

18

/

20

Passed

Description

71%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, third-person description that comprehensively covers what the skill does across GitHub and GitLab. Its main weakness is the complete absence of a "Use when..." trigger clause, which caps completeness and limits natural trigger-term coverage.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to create, open, or submit a pull request or merge request, or says PR/MR is ready."

Include natural user phrasings and synonyms such as "open a PR", "submit a merge request", and "draft PR" to strengthen trigger-term coverage.

Clarify that the self-review + checks step is a pre-flight of the created PR/MR (not a general code-review capability) to reduce overlap with code-review skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions in third person ("runs self-review + checks", "writes a structured description (TL;DR, change table, mermaid flow, honest verification status...)", "adapts the project's `.gitlab/merge_request_templates` template", "Opens as a draft when verification is incomplete"), giving comprehensive coverage of the skill's behavior. It is not 4 because the actions span the whole pipeline rather than having minor coverage gaps.

5 / 5

Completeness

The "what" is clearly and concretely described, but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description; per the rubric guideline a missing 'Use when' clause caps completeness at 3. Not 4 because the "when" is not weakly implied, it is absent.

3 / 5

Trigger Term Quality

Good keyword coverage: "PR/MR creation", "GitHub `gh`", "GitLab `glab`", "merge_request_templates". Natural terms like "open a pull request", "submit a PR/MR", or "draft" are missing, so it does not reach the comprehensive synonym-level coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (VCS-aware PR/MR creation pipeline with template adaptation and draft logic), but "runs self-review + checks" overlaps with code-review skills and the absent trigger clause leaves minor overlap risk, matching "mostly distinct; minor overlap risk with closely related skills".

4 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

AndreJorgeLopes/devflow

Path

devflow-plugin/skills/create-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.