CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

leaving-pr-comments

Use whenever leaving comments on GitHub.

Quality

76%

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 ./plugins/tstack/skills/leaving-pr-comments/SKILL.md
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 a model instruction-only skill: a concrete copy-paste template, precise placement and scope rules, and an explicit preview→post→verify→resolve sequence with validation. It is lean with no padding and appropriately self-contained at its size. No weaknesses found.

DimensionReasoningScore

Conciseness

Every sentence is a rule ("Keep the attribution inside the note and the actual reply outside it", "Do not guess") with no padding and no explanation of concepts Claude already knows. The ~40-line body assumes Claude's competence; not 4 because there is no over-explanation to trim.

5 / 5

Actionability

A copy-paste-ready template is given (the `> [!NOTE]` / `🤖 **<model> responding on behalf of <user>**` block) plus concrete edge-case handling ("If the harness does not expose a model name, use the harness name") and explicit inclusions/exclusions ("Do not add it to PR descriptions, commit messages, or text the user explicitly asked to post verbatim"). Per the rubric's code_vs_instruction note, this instruction-only guidance is fully executable; not 4 because the common cases are covered with no gaps.

5 / 5

Workflow Clarity

A simple single-purpose skill with an unambiguous action, and the final paragraph gives an explicit ordered sequence with validation: "Preview the final Markdown before posting", "After posting, verify that GitHub returned the comment or review URL", "Resolve a review thread only after its response was posted successfully" — a full post-verification feedback loop. Not 4 because checkpoints are explicit rather than implicit; no destructive/batch cap applies since posting a comment is a single non-destructive operation.

5 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references — no references/, scripts/, or assets/ files exist in the bundle, and none are needed. Content is organized into clear thematic paragraphs (template, attribution rules, scope, comment style, verification), meeting the rubric's simple-skill exception; not 4 because there is no misplaced inline content and no organization gaps at this size.

5 / 5

Total

20

/

20

Passed

Description

40%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 has a clear, explicit trigger and a distinct niche, but it omits the 'what' entirely — a reader cannot tell the skill governs attribution formatting for agent-authored comments. It also lacks natural trigger variants like "PR" or "pull request". Adding one sentence of concrete capabilities would move it up two levels.

Suggestions

State what the skill does, e.g. "Formats agent-authored comments with a model/user attribution callout..." so the description answers both 'what' and 'when' (completeness, currently the lowest dimension).

Add natural trigger variants users would actually say: "Use whenever leaving PR comments, review comments, or replies on GitHub" (trigger_term_quality).

Include 1-2 concrete actions such as "prefix with a 🤖 attribution note and verify the posted comment URL" to raise specificity beyond domain-naming only.

DimensionReasoningScore

Specificity

The description "Use whenever leaving comments on GitHub" names the domain but states zero concrete actions — it never says what the skill does (prefix agent-authored comments with an attribution callout). This matches the anchor "Names the domain but actions are minimal or generic" ("Processes PDF files"); not 1 because it is more specific than pure abstraction like "Helps with documents", and not 3 because no 1-2 concrete actions are listed.

2 / 5

Completeness

Only the 'when' is present ("Use whenever leaving comments on GitHub") with no 'what' — the description never states that the skill formats agent-authored comments with a model/user attribution callout. This is structurally identical to the anchor example "Use when working with documents" ("only 'when' is present without 'what'"); not 1 because the 'when' is explicit and clear, and not 3 because even a vague 'what' is absent.

2 / 5

Trigger Term Quality

"leaving comments" and "GitHub" are natural terms a user might say, but common variations are missing: "PR", "pull request", "review comments", "replies", "inline comments". This fits "Some relevant keywords but missing common variations or synonyms" ("Works with PDF files"); not 2 because the keywords are domain-specific rather than generic, and not 4 because coverage is essentially one phrase plus the platform name.

3 / 5

Distinctiveness Conflict Risk

"leaving comments on GitHub" carves a clear niche with a distinct trigger, with only minor overlap risk against closely related skills (e.g., a general GitHub/PR-management or code-review skill that also posts comments). Matches "Mostly distinct; minor overlap risk with closely related skills"; not 5 because no distinct trigger phrasing (PR comments, review replies) is enumerated to fully disambiguate, and not 3 because the niche is narrower than "Works with document files".

4 / 5

Total

11

/

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

adamsardo/tstack-marketplace

Path

plugins/tstack/skills/leaving-pr-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.