CtrlK
BlogDocsLog inGet started
Tessl Logo

github-pr-review-fix

Review and resolve PR comments from GitHub. Validates each comment, fixes legitimate issues.

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/github-pr-review-fix/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 skill delivers a fully executable, well-sequenced workflow with strong validation checkpoints for destructive and batch operations, including sub-agent conflict avoidance and safe-fail handling. The only notable improvement is moving the long prompt template and GraphQL queries into reference files and tightening the repeated reply templates.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, GraphQL queries, and a sub-agent template rather than explanations of concepts Claude already knows, matching 'efficient; minor instances of over-explanation'. It is not 5 because the three near-identical agentic-reply templates and the two long thread-discovery GraphQL queries could be tightened, but it is clearly above 3's 'some unnecessary explanation'.

4 / 5

Actionability

Every step gives copy-paste-ready `gh` CLI commands and complete GraphQL queries, an exact sub-agent prompt template with a structured report format, and a concrete summary-table example. This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

A clear five-step sequence with explicit validation checkpoints: comment validation by sub-agents (FIX/IGNORE/NEEDS_MANUAL_REVIEW verdicts with confidence), sequential execution for same-file conflicts, stop conditions for no PR or zero comments, and failure handling ('If the resolve call fails, note it in the report but do not block on it'). Destructive/outbound operations (thread replies, resolutions, code fixes) are all gated by validation, satisfying the feedback-loop cap.

5 / 5

Progressive Disclosure

The body is well-organized into clearly signaled steps with no bundle files and no nested references, so navigation is easy. It is not 5 because at ~210 lines it exceeds the under-50-line simple-skill exception, and the sub-agent prompt template plus the GraphQL query collection would sit more appropriately in reference files; it is well above 3, which expects content that should be separate being inline with unclear signaling.

4 / 5

Total

18

/

20

Passed

Description

58%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 states a clear, moderately specific purpose in third person, but entirely omits trigger guidance ('when to use'), which caps completeness and weakens trigger term quality. Natural synonyms like 'pull request' and 'review feedback' are missing.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user asks to address, fix, or resolve pull request review comments' — this directly lifts completeness from 3.

Include natural trigger variations users would actually say: 'pull request', 'PR review feedback', 'address review comments', 'reply to review threads'.

Mention the distinctive outcomes (fixes code, replies to threads, resolves conversations) to sharpen both specificity and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ("PR comments from GitHub") and several concrete actions ("Review and resolve", "Validates each comment", "fixes legitimate issues"), matching the 'lists several specific actions; minor gaps in coverage' anchor. It falls short of 5 because coverage is incomplete — resolving threads, replying, and reporting outcomes are absent — but exceeds 3, which expects only 1-2 actions.

4 / 5

Completeness

The 'what' is clear (validate and fix PR review comments), but there is no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the rubric guidelines. It sits at level 3 ('clear what but when is missing') rather than 4, which requires an explicit 'when'.

3 / 5

Trigger Term Quality

"PR comments" and "GitHub" are relevant keywords, but common natural variations are missing — "pull request" is never spelled out, nor are phrases like "address review feedback" or "reply to comments". This matches 'some relevant keywords but missing common variations or synonyms'; it is not level 4, which requires good coverage with only a few terms missing.

3 / 5

Distinctiveness Conflict Risk

Resolving GitHub PR review comments is a clear niche with mostly distinct triggers, but it overlaps with generic code-review and PR-review skills. This fits 'mostly distinct; minor overlap risk with closely related skills'; it does not reach 5 because the description itself gives no distinguishing trigger phrasing, and is well above 3's overlap-with-similar-skills profile.

4 / 5

Total

14

/

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
IvanMurzak/Unity-MCP
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.