CtrlK
BlogDocsLog inGet started
Tessl Logo

comprehensive-review-pr-enhance

Generate structured PR descriptions from diffs, add review checklists, risk assessments, and test coverage summaries. Use when the user says "write a PR description", "improve this PR", "summarize my changes", "PR review", "pull request", or asks to document a diff for reviewers.

84

2.61x
Quality

87%

Does it follow best practices?

Impact

68%

2.61x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-built, token-efficient instruction skill with a strong template, concrete commands, and condition-driven checklists. Its main defects are the missing validation/feedback step in the workflow and a Resources section pointing at a file that is not present in the bundle.

Suggestions

Ship the referenced resources/implementation-playbook.md (or remove/fix the Resources section) so the skill's only external reference is not a dead pointer.

Add a validation step to the workflow, e.g. cross-check the Changes table against the 'git diff --stat' file list and confirm every changed file is categorized before emitting the description.

Trim the generic Limitations section to the one non-obvious constraint (large-diff splitting threshold) and drop boilerplate lines Claude would infer anyway.

DimensionReasoningScore

Conciseness

The body is lean and dense — a copy-paste template, two compact tables, and concrete thresholds with no explanations of concepts Claude already knows. The generic 'Limitations' boilerplate ('Do not treat the output as a substitute for environment-specific validation...') and somewhat obvious checklist items ('descriptive names', 'accurate' docs) are the minor padding that keeps it below a 5.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: 'git diff <base>...HEAD --stat', a complete copy-paste PR description template, a category-to-checklist mapping table, and exact thresholds ('20 files or 1000 lines', '>500 lines') with commands ('git checkout -b feature/part-1', 'git cherry-pick'). It is not a 4 because no step requires the reader to invent structure or syntax — every output artifact is specified.

5 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with concrete inputs at each step and condition-based branching (checklist sections 'only when the matching file category appears'). It is not a 5 because there are no validation checkpoints or feedback loops (e.g., verifying the generated description covers every file from the --stat output), though the read-only nature of the task means the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

Sections are well-organized and the reference is clearly signaled ('resources/implementation-playbook.md — Python helpers for automated PR analysis, coverage reports, and risk scoring'), but that sole referenced file does not exist in the bundle (no references/, scripts/, assets/, or resources/ directory), making the one navigation pointer dangling. Structure is better than a 2, but a broken main reference is more than the 'minor organization gaps' allowed at 4.

3 / 5

Total

16

/

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 states concrete capabilities and an explicit, natural-language trigger list with synonyms. The only weakness is that 'PR review' as a trigger may route users who want code review of a PR — rather than PR description generation — to this skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Generate structured PR descriptions from diffs, add review checklists, risk assessments, and test coverage summaries' — comprehensively covering the skill's outputs. It is not a 4 because there is no noticeable gap: every capability the body delivers is named.

5 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: what ('Generate structured PR descriptions from diffs...') and when ('Use when the user says...'), matching the top anchor's structure. A 4 would require the 'when' clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural, including synonyms: 'write a PR description', 'improve this PR', 'summarize my changes', 'PR review', 'pull request', 'document a diff for reviewers' — phrases a user would plausibly say verbatim. Unlike a 4, no common variation of the request is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (generating PR descriptions from diffs) and mostly distinct, but the trigger 'PR review' is ambiguous with skills that actually review PR code (e.g., a code-review skill), creating minor overlap risk with a closely related skill. It is not a 5 because of that trigger collision, and clearly not a 3 since the overlap is confined to one phrase within an otherwise distinct trigger set.

4 / 5

Total

19

/

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
sickn33/agentic-awesome-skills
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.