CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-review-comments

Posts review findings from a JSON file as inline comments on a GitHub Pull Request, attaching each comment to its file and line. Use when you have a list/JSON of review findings (each with a file path, line number, and a message such as summary/failure_scenario) and want them published on a PR as inline review comments. Triggers include "post these review comments on the PR", "associate comments to files in the PR", "publish review findings to PR

79

Quality

99%

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

100%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 an exemplar of skill writing: lean sections that each add non-obvious value, fully executable commands, a workflow with a real validation checkpoint and error-recovery loop, and clean one-level bundling of the schema into a verified reference file. Nothing explains what Claude already knows, and no section is padded.

DimensionReasoningScore

Conciseness

Every section carries non-obvious, skill-specific information — the diff-line commentability constraint, the dry-run-first rule, mode selection — with no explanation of concepts Claude already knows (no primers on gh, PRs, or diffs). The body is lean for what it covers; the only repetition (restating the diff constraint) preempts the natural "can't I comment anyway?" question rather than padding, fitting the "every token earns its place" anchor better than the 4 anchor's trimmable over-explanation.

5 / 5

Actionability

Copy-paste-ready commands for every path: `scripts/post_pr_comments.py --pr <N> --json <path> --dry-run`, both posting modes, plus a complete options reference and a mode-to-endpoint table. All commands reference the real bundled script (verified to exist), matching the fully-executable anchor with the common cases (grouped default and individual) covered.

5 / 5

Workflow Clarity

The 5-step workflow has an explicit validation checkpoint ("**Dry-run first** to see what will be posted and what gets skipped"), a feedback loop for error recovery (skipped lines mean stale numbers — "reconcile before posting"), and a final reporting step for created URLs and skipped findings. The batch-operation validation cap does not apply because validation is present, so this matches the explicit-validation anchor rather than the 4 anchor's "minor validation gaps".

5 / 5

Progressive Disclosure

The body is a concise overview with a well-signaled, one-level-deep reference — "See [references/json-schema.md](references/json-schema.md) for the full schema and a sample" (file verified to exist and contain exactly that) — and the script used throughout (also verified). Content is appropriately split: the schema detail lives in the reference file, usage guidance inline, with no nested references, matching the clear-overview anchor.

5 / 5

Total

20

/

20

Passed

Description

100%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 a model example: third-person voice, a concrete "what", an explicit "Use when..." clause, and quoted natural trigger phrases with synonyms. It is detailed without padding — every clause serves specificity, trigger quality, completeness, or distinctiveness.

DimensionReasoningScore

Specificity

"Posts review findings from a JSON file as inline comments on a GitHub Pull Request, attaching each comment to its file and line" names the concrete action, destination, and anchoring mechanism, and further specifies the input shape ("each with a file path, line number, and a message such as summary/failure_scenario"). Coverage of the skill's purpose is comprehensive with no vague language, matching the multiple-concrete-actions anchor rather than the 4 anchor (which expects gaps).

5 / 5

Completeness

Sentence one explicitly answers "what" (posts findings from a JSON file as inline PR comments anchored to file and line) and the second explicitly answers "when" ("Use when you have a list/JSON of review findings... and want them published on a PR as inline review comments") with concrete trigger phrases — exactly the anchor-5 pattern. The 4 anchor would require a weaker or less specific "when", which is not the case.

5 / 5

Trigger Term Quality

Quotes natural phrases users would actually say ("post these review comments on the PR", "associate comments to files in the PR", "publish review findings to PR #N") and covers synonyms — review findings/review comments, inline comments, PR/pull request, JSON array — including a data-shape trigger ("a JSON array of {file, line, summary}"). This matches the comprehensive-coverage anchor; the 4 anchor would require missing natural terms, and none are missing.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — publishing structured review findings as inline comments on a GitHub PR — with triggers distinct from generic commenting, review, or GitHub skills. Conflict risk is minimal, matching the clear-niche anchor rather than the 4 anchor's "minor overlap risk with closely related skills".

5 / 5

Total

20

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

giuseppe-trisciuoglio/developer-kit

Path

plugins/developer-kit-core/skills/pr-review-comments/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.