CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-pr

Writes a short narrative PR description (≤ 25 lines, hard ceiling 40), converges the branch with review-loop in local mode, pushes, opens a draft PR, runs review-loop until every thread is resolved, and hands red CI to ci-auto-fix. Flags: --split (2–4 dependency-ordered draft PRs), --quick, --no-review, --no-simplify, --no-quality, --no-pre-review, --no-post-review, --no-ui-verify, --no-media; invoke with /create-pr.

Quality

82%

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

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.

An exceptionally actionable, well-sequenced command skill with strong validation checkpoints, explicit feedback loops, and guardrails — among the strongest workflow content one could ask for. Its one real defect is bundle integrity: most of the rules/*.md files it delegates to are absent from the bundle, leaving load-bearing steps (especially split mode and the description contract) unnavigable.

Suggestions

Ship the missing rules/ files in the bundle — or inline the load-bearing ones (split-mode procedure, pre-push skip conditions, description contract) — since 7 of 8 referenced local files are currently dangling.

Verify relative paths after any move: links like ../../quality/review-loop/SKILL.md and ../../../agents/shared/rules/github-access.md silently break outside the expected repo layout.

DimensionReasoningScore

Conciseness

The body is dense and operational — no explanations of git/GitHub/CI concepts Claude already knows, and nearly every line is a non-obvious harness fact ("gh pr checks exits non-zero (8) while checks are merely pending", "Issue each watch call with the Bash tool's timeout parameter explicitly set to 600000"). Minor trimming is possible: skip conditions are stated both in the Modes table and again per-step ("Skip entirely on --no-quality, --no-post-review..."), and the "Record which branch you took, now" motif repeats across steps — that keeps it at 4 rather than 5.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready commands ("gh pr create --draft --title ... --body ...", "timeout 540 gh pr checks <pr-number> --watch", "Skill("ci-auto-fix", "<pr-url>")"), exact exit-code-to-action tables (0/124/127/other), a precedence-ordered flag table, and enum-valued report slots. It matches the 5 anchor — concrete commands with the common cases specifically covered.

5 / 5

Workflow Clarity

Steps are explicitly sequenced with validation checkpoints at every phase: outcome values recorded before continuing, exit-code classification with literal stderr matches, retry caps with escalation ("up to 4 attempts total... After the fourth... escalate"), ci-auto-fix capped at 2 with re-invoke rules, and a mandatory Step 10 report checklist. Feedback loops and error-recovery paths are present throughout, matching the 5 anchor exactly.

5 / 5

Progressive Disclosure

The structure itself is well designed — one-level-deep references, each with an explicit read-condition ("read when --split is set, before Step 1", "read now") — but scored against the actual bundle, 7 of the 8 referenced local files are missing: rules/description-contract.md, rules/description-examples.md, rules/legacy-flags.md, rules/pre-push-review.md, rules/attach-media-step.md, rules/registration-poll.md, and rules/split-mode.md do not exist, and split mode's entire procedure lives in one of them. Only references/design-rationale.md is real, so the navigation the body promises is broken in practice — better than the disorganized 2 anchor, but the missing load-bearing files preclude 4 or 5.

3 / 5

Total

17

/

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, third-person description that concretely covers the entire workflow and is clearly distinct from related review/CI skills. Its one structural weakness is the absence of any explicit "Use when..." trigger guidance, which caps completeness, and the trigger vocabulary omits natural variants like "pull request".

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to create, open, or submit a pull request for the current branch."

Spell out "pull request" at least once alongside "PR" so users who say the full phrase match naturally.

DimensionReasoningScore

Specificity

The description enumerates the complete pipeline as concrete actions — "Writes a short narrative PR description (≤ 25 lines, hard ceiling 40)", "converges the branch with review-loop in local mode", "pushes, opens a draft PR", "runs review-loop until every thread is resolved", "hands red CI to ci-auto-fix" — with quantitative bounds and a full flag inventory. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); score 4 would require minor coverage gaps, and none are present.

5 / 5

Completeness

The "what" is clearly and concretely answered, but there is no "Use when..." clause or equivalent explicit trigger guidance — "invoke with /create-pr" is invocation syntax, not a when-to-use statement. Per the judging guidelines, a missing trigger clause caps completeness at 3 even with a strong "what".

3 / 5

Trigger Term Quality

Natural domain keywords are present — "PR description", "draft PR", "CI", "review" — but common user phrasings are missing: "pull request" is never spelled out, and request verbs like "open" or "submit a PR" are absent. Good coverage with a few natural terms missing fits the 4 anchor; it is not 5 because synonym/variant coverage is incomplete, and not 3 because the terms present are exactly what a user needing this skill would say.

4 / 5

Distinctiveness Conflict Risk

A clear creation-side niche — writing the PR body, opening a draft, converging, watching CI — anchored by distinctive triggers ("PR description", "draft PR", "ci-auto-fix"). The named sibling skills (review-loop, pr-reviewer) cover review-side work, so overlap risk is minimal; the 4 anchor (minor overlap with closely related skills) does not fit better.

5 / 5

Total

17

/

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: 4 missing, 2 suspicious

Warning

Total

14

/

16

Passed

Repository

mthines/agent-skills

Path

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