CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-pr

Create Git branches, commits, pushes, and GitHub pull requests for Next.js. Use when the user asks to create a branch, commit current changes, open a PR or draft PR, publish a pull request, or recover from gh pr create / PR template issues. Covers .github/pull_request_template.md, --body formatting, <agent-name>/ branch names, and Codex app git directives.

Quality

94%

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.

A high-quality, self-contained workflow skill: executable commands end to end, a properly sequenced process with validation checkpoints and error-recovery paths, and clean single-file organization with a well-signaled policy reference. The PR-body guidance section is the only spot that could be tightened for token efficiency.

DimensionReasoningScore

Conciseness

Lean overall with no concept padding — every command block is tight and policy notes are repo-specific — but the PR-body prose ('A "why" should be included...' followed by 'Omitting the "why" should be used sparingly...') and the three-clause test-command rule are meandering and could be trimmed into fewer sentences, matching the 'efficient; minor over-explanation' anchor rather than 'every token earns its place'.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the entire pipeline (git status --short, git switch -c, git add, git diff --cached --check, git commit, git push -u, gh pr create --draft --base canary, gh pr view --json) plus a filled-in PR body template with concrete section structure.

5 / 5

Workflow Clarity

A clear 5-step sequence (inspect → branch → commit → push → PR) with explicit validation before mutating Git, a pre-commit check ('git diff --cached --check'), a duplicate-PR check ('gh pr view --head'), and feedback loops for error recovery (sandbox-escalation retries for lock/network errors, denied-approval handling). The destructive-operation validation cap does not apply since checks are present.

5 / 5

Progressive Disclosure

A single, well-organized file with clear sections for the workflow, PR body, and recovery; the one external reference ('See "GitHub Pull Requests and Issues" in AGENTS.md for the full policy') is well-signaled and exactly one level deep, and no bulk content exists that would benefit from splitting into bundle files.

5 / 5

Total

19

/

20

Passed

Description

96%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 that explicitly states both what and when, enumerates concrete actions across the full PR-creation pipeline, and uses natural trigger phrasing with synonyms and tool-specific terms. The only weakness is that a few generic git triggers could collide with adjacent commit-focused skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'Create Git branches, commits, pushes, and GitHub pull requests' — plus recovery ('recover from gh pr create / PR template issues') and concrete artifacts ('.github/pull_request_template.md', '--body formatting', '<agent-name>/ branch names', 'Codex app git directives'). Comprehensive coverage of the PR-creation domain; not merely the 4-anchor 'minor gaps' level.

5 / 5

Completeness

Explicitly answers both: what ('Create Git branches, commits, pushes, and GitHub pull requests for Next.js') and when ('Use when the user asks to create a branch, commit current changes, open a PR or draft PR, publish a pull request, or recover from gh pr create / PR template issues') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Triggers read as natural user requests — 'create a branch', 'commit current changes', 'open a PR or draft PR', 'publish a pull request' — with synonyms (PR / pull request), tool-specific terms ('gh pr create'), and file-level specifics ('.github/pull_request_template.md'). Matches the comprehensive synonym-plus-extension anchor rather than the 4-anchor 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Clear niche — the Next.js branch-to-PR pipeline with distinctive recovery triggers — but generic triggers like 'create a branch' and 'commit current changes' overlap with closely related git/commit-message skills, matching the 'mostly distinct; minor overlap risk' anchor rather than 'minimal conflict risk'.

4 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

vercel/next.js

Path

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