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

84%

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

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, dense procedural skill: an unambiguous sequenced workflow with validation gates and approval checkpoints, fully executable commands for every provider path, and lean rule sections that only justify constraints Claude could not infer. The only structural improvement would be moving the GitLab template-adaptation detail into a reference file.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence (no explanation of what a PR is), with commands and rules stated tersely; parenthetical rationales ('a heredoc-to-file can silently land 0 bytes', 'Em-dashes read as machine-written') are project-specific constraints, not padding. Not 5 because a few asides ('renders fine on GitLab', the em-dash rationale) could be trimmed without losing guidance.

4 / 5

Actionability

Fully executable throughout: exact gather-context commands, provider detection rules, a fallback command chain ('devflow check # or, if unavailable: yarn lint && yarn build && yarn test --changedSince=main'), a complete structured body template, and copy-paste-ready 'gh pr create' and 'glab mr create' invocations. Specific examples cover the common GitHub, GitLab, and unknown-provider cases.

5 / 5

Workflow Clarity

A clearly sequenced 10-step pipeline with explicit validation checkpoints and feedback handling: checks run at step 3, step 4 gates on issues ('ask the user whether to fix first or proceed'), step 7 requires approval of the draft, and the draft-when-unverified rule plus 'Never open a PR/MR with failing checks' close the loop. The creation step includes a checklist for the resulting PR.

5 / 5

Progressive Disclosure

The body is well-sectioned (Steps, Description rules, Provider assembly, Creating the PR/MR, Important) and external detail is delegated by pointer to CLAUDE.md and lib/utils.sh rather than inlined. Not 5 because the ~30-line GitLab template-adaptation subsection is sizeable inline content with no reference-file split, leaving minor organization gaps; not 3 because navigation is easy and nothing is buried.

4 / 5

Total

18

/

20

Passed

Description

75%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, distinct description that comprehensively states what the skill does, including provider-specific behaviors. Its main weakness is the absence of any 'Use when...' trigger clause, which both caps completeness and leaves natural trigger phrasing implicit.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to create/open a pull request or merge request, or wants a branch proposed for review.'

Include the spelled-out natural phrases 'pull request' and 'merge request' as trigger keywords alongside 'PR/MR' so searches on the full words match.

Trim implementation detail (e.g. 'no em-dashes', template fill mechanics) to make room for the when-to-use guidance without growing the description.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage of the pipeline: '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', and 'Opens as a draft when verification is incomplete'. Not below 4 because coverage goes beyond several specific actions to include edge-case behaviors (template adaptation, draft logic) that leave no minor gaps.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric guideline completeness is capped at 3 ('when' is at best weakly implied by the pipeline name). Not 4 because the 'when' is not present in any explicit or specific form.

3 / 5

Trigger Term Quality

Good keyword coverage including 'PR/MR creation', 'GitHub gh', 'GitLab glab', and 'merge_request_templates', which match phrases users naturally say when asking to open a pull or merge request. Not 5 because natural variations like 'pull request' spelled out, 'open a PR', or 'merge request' as a standalone trigger phrase are missing; not 3 because the included terms are relevant and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (creating PRs/MRs with specific tooling for GitHub and GitLab, template adaptation, draft gating) with distinct triggers unlikely to fire for a commit-message or code-review skill. The mention of 'self-review' has only negligible overlap risk with a dedicated review skill.

5 / 5

Total

17

/

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

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.