CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-pr-workflows-pr-enhance

Improve pull request descriptions, change summaries, validation details, and review workflows. Use when preparing a pull request or making an existing proposal easier to evaluate.

50

Quality

63%

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
SKILL.md
Quality
Evals
Security

Quality

Content

25%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 reads as a generic template: tautological scope sections, restated context, and abstract instructions with no concrete workflow, template, or example. Its one promise of actionable detail — the implementation playbook — is a broken reference to a nonexistent file, leaving the skill unable to actually guide PR enhancement. Only the Output Format section provides mildly concrete guidance.

Suggestions

Replace the abstract Instructions bullets with a concrete sequenced workflow: gather the change scope (e.g., `git diff main...HEAD --stat`), draft each Output Format deliverable from an explicit PR description template (Summary / Changes / Testing / Risk), then verify claims such as coverage numbers and checklist items against the actual diff.

Delete the zero-information sections — both 'Do not use this skill when' bullets, the Context section that restates the frontmatter description, and the 'pleasure to review' closing sentence — and fold the 'Use this skill when' bullets into the description since they duplicate it.

Fix the broken reference: `resources/implementation-playbook.md` does not exist in the bundle. Either create that file with the promised patterns, templates, and examples (and correct the nonstandard `resources/` path to a real bundle directory), or remove both mentions and inline the essential guidance in SKILL.md.

DimensionReasoningScore

Conciseness

Several sections are pure padding: the tautological 'Do not use this skill when' bullets ('The task is unrelated to pull request enhancement', 'You need a different domain or tool outside this scope'), the Context section restating the frontmatter description, and the closing 'Focus on creating PRs that are a pleasure to review' sentence — roughly a third of the body adds no information. This matches anchor 2 ('several unnecessary explanations or padded sections'); it is not 3 because the padding goes beyond 'some' unnecessary explanation, and not 1 because the document is short and never explains concepts Claude already knows.

2 / 5

Actionability

The Instructions are abstract hints — 'Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes', 'Provide actionable steps and verification' — with no commands, templates, or examples; the only concrete structure is the 8-item Output Format list, and the pointer to detailed examples ('open `resources/implementation-playbook.md`') targets a file that does not exist in the bundle. This matches anchor 2 (minimal concrete guidance, missing the specific steps to execute); it is not 1 because the Output Format enumerates concrete deliverables, and not 3 because nothing in the body is executable or example-driven — even the promised examples are inaccessible.

2 / 5

Workflow Clarity

The Instructions offer only a rough abstract sequence (clarify → apply → provide steps) with no defined steps for the actual PR-enhancement workflow and no real validation checkpoint — 'Apply relevant best practices and validate outcomes' gestures at validation without defining what to check or how. This matches anchor 2 (rough sequence present but many gaps, validation effectively absent); it is not 3 because the Output Format is a deliverable list, not a step sequence, and no genuine checkpoints are defined anywhere.

2 / 5

Progressive Disclosure

Sections are clearly headed, but the skill's only external reference — 'resources/implementation-playbook.md', cited in Instructions, Output Format context, and a Resources section — does not exist (no resources/, references/, scripts/, or assets/ directories in the bundle), so the promised detailed patterns and examples are inaccessible. This matches anchor 2 (minimal effective structure / broken references); it is not higher because a dangling reference fails navigation outright (the under-50-lines exception doesn't apply since the skill explicitly calls for an external file), and not 1 because headers are clear and reference depth is only one level.

2 / 5

Total

8

/

20

Passed

Description

83%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 is strong: it states concrete capabilities in third person, includes an explicit 'Use when' clause with natural trigger phrases, and occupies a distinct niche. Minor improvements would be adding common synonyms like 'PR' and 'PR description' and enumerating more distinct operations (generate, split large PRs, automate checks) rather than the blanket 'improve'.

DimensionReasoningScore

Specificity

'Improve pull request descriptions, change summaries, validation details, and review workflows' names several concrete objects of work, matching anchor 4 ('Lists several specific actions; minor gaps in coverage'). It is not 5 because the single verb 'Improve' dominates rather than multiple distinct concrete operations (generate, split, automate), leaving gaps like drafting PRs from diffs or review automation; it is well above 3 because it goes beyond naming just 1-2 actions.

4 / 5

Completeness

It explicitly answers both questions: what ('Improve pull request descriptions, change summaries, validation details, and review workflows') and when ('Use when preparing a pull request or making an existing proposal easier to evaluate') with concrete trigger phrases, structurally identical to the anchor-5 example. It is not 4 because the 'when' clause names two specific trigger scenarios rather than being merely present-but-imprecise.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — 'pull request', 'change summaries', 'preparing a pull request', 'making an existing proposal easier to evaluate' — matching anchor 4 (good keyword coverage, a few natural terms missing). It is not 5 because common variations are absent: the abbreviation 'PR', 'PR description', 'draft PR', and 'code review'; it is clearly above 3 because the trigger clause is explicit and multi-phrase rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The PR-description/review niche is mostly distinct with clear triggers around pull request preparation, matching anchor 4 ('Mostly distinct; minor overlap risk'). It is not 5 because the broad 'review workflows' and 'validation details' phrases could collide with general code-review or commit-message skills; it is well above 3 because the core triggers are unambiguous.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rmyndharis/antigravity-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.