CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-pr-workflows-pr-enhance

You are a PR optimization expert specializing in creating high-quality pull requests that facilitate efficient code reviews. Generate comprehensive PR descriptions, automate review processes, and ensu

40

Quality

51%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/git-pr-workflows-pr-enhance/SKILL.md

The canonical home for this skill is git-pr-workflows-pr-enhance in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

36%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.

The body is a skeletal template: sections are well-labeled but the instructions are generic boilerplate with no executable guidance, no examples, and a reference to a playbook file that does not exist in the bundle. A Claude following this skill would gain almost nothing domain-specific about actually enhancing pull requests.

Suggestions

Replace the generic instruction bullets with domain-specific steps for PR enhancement (e.g., how to gather the diff, draft the summary, compute size metrics, and split oversized PRs), or ship the playbook with that content.

Create the referenced 'resources/implementation-playbook.md' (and fix the non-standard directory name — bundle convention is 'references/') so the pointer in Instructions and Resources resolves to a real file.

Add at least one concrete example, such as a filled-in PR description template or a command for generating PR stats, to make the Output Format section actionable.

DimensionReasoningScore

Conciseness

The body is short (~45 lines) and does not explain concepts Claude already knows, so it avoids the verbose anchors. However, it contains unnecessary filler: 'The task is unrelated to pull request enhancement' and 'You need a different domain or tool outside this scope' say nothing, and the generic instruction bullets ('Clarify goals, constraints, and required inputs') could be tightened, matching the 'mostly efficient but some unnecessary content' anchor.

3 / 5

Actionability

Guidance is abstract throughout: 'Apply relevant best practices and validate outcomes', 'Provide actionable steps and verification' — no commands, no example PR description, no concrete steps. The 8-item Output Format list provides minimal concrete shape (high-level hints), but the specific steps needed to actually produce the output are missing, and the only concrete pointer ('open resources/implementation-playbook.md') targets a file that does not exist in the bundle.

2 / 5

Workflow Clarity

The Instructions section offers a rough generic sequence (clarify goals → apply best practices → provide steps → optionally open the playbook), but the steps are template boilerplate with no domain-specific sequencing for PR enhancement work and no validation checkpoints. This matches 'rough sequence present but many gaps; steps poorly defined; validation absent' rather than 3, where the listed steps would be real, domain-specific steps.

2 / 5

Progressive Disclosure

Section structure is reasonable and the single reference ('resources/implementation-playbook.md') is clearly signaled in both Instructions and Resources, but no bundle files or directories exist in the skill — the referenced playbook is a dangling path, so navigation is broken. Per the guideline to score against the actual bundle structure, the broken reference prevents a 4; the otherwise decent organization keeps it above 2.

3 / 5

Total

10

/

20

Passed

Description

45%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.

The description communicates a clear domain (PR authoring and review facilitation) with a couple of concrete capabilities, but it is truncated mid-word, lacks any 'Use when' trigger clause, and opens in second-person voice. These defects leave it below the quality bar for reliable skill triggering.

Suggestions

Complete the truncated description — it cuts off mid-word at 'ensu', losing at least one capability and any trigger guidance that may have followed.

Add an explicit trigger clause, e.g. 'Use when the user asks to create, describe, or improve a pull request, or wants a PR reviewed before merging.'

Rewrite in third person ('Creates and enhances pull requests...') instead of the persona-style 'You are a PR optimization expert'.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — 'Generate comprehensive PR descriptions, automate review processes' — matching the level-3 anchor of 1-2 concrete actions without comprehensive coverage (the third action is cut off mid-word at 'ensu'). It is written in second person ('You are a PR optimization expert'), which per the judging guidelines reduces the specificity score by 1, landing at 2.

2 / 5

Completeness

The 'what' is reasonably clear (generate PR descriptions, automate review processes), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. It cannot score 4 because the 'when' is entirely absent rather than merely implicit or under-specified.

3 / 5

Trigger Term Quality

It contains relevant keywords users might say — 'pull requests', 'PR descriptions', 'code reviews' — but misses common variations and context terms like 'GitHub', 'draft a PR', 'review my PR', or 'merge request'. This sits at the 'some relevant keywords but missing variations' anchor, not 4, because coverage of natural phrasings is incomplete and the truncation further limits it.

3 / 5

Distinctiveness Conflict Risk

The PR-authoring niche ('creating high-quality pull requests that facilitate efficient code reviews') is somewhat specific, but 'automate review processes' and 'PR optimization' overlap with code-review, git-commit-message, and general git-workflow skills. It is not the very-broad anchor 2, since the triggers are anchored to pull requests, but the overlap with closely related skills keeps it at 3.

3 / 5

Total

11

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/git-pr-workflows-pr-enhance/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.