CtrlK
BlogDocsLog inGet started
Tessl Logo

comment-writer

Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.

76

Quality

95%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is concise, actionable, and well-organized, with concrete examples and an executable command that assume Claude's competence without padding. It is a strong, self-contained skill body with no structural weaknesses.

DimensionReasoningScore

Conciseness

The body is lean with a tight rules table, a compact formula, and minimal examples, and it never explains concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor.

3 / 3

Actionability

It gives a concrete comment formula, three fully-written example comments, and an executable `gh pr view` command, providing specific copy-paste-ready guidance for an instruction skill.

3 / 3

Workflow Clarity

This is a simple single-task skill where the action (observation -> why -> next action) is unambiguous, so per the simple-skill note workflow clarity scores full marks without needing multi-step validation.

3 / 3

Progressive Disclosure

All content is appropriately organized into clearly labeled sections with no external references needed, so the well-organized-sections path for compact skills applies.

3 / 3

Total

12

/

12

Passed

Description

90%

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 clearly answers both what it does and when to use it with natural trigger terms and a distinct niche. Its only weak spot is specificity, since it names one action rather than enumerating several concrete capabilities.

Suggestions

Add one or two more concrete actions (e.g. 'draft review feedback, reply to issues, write async updates') to lift specificity from naming one action to listing multiple.

Keep the existing 'Trigger:' clause, which already satisfies the explicit-when requirement, while expanding the capability verb list.

DimensionReasoningScore

Specificity

The phrase "Write warm, direct collaboration comments" names a single action with modifiers rather than listing multiple specific concrete actions, so it sits at the 'names domain and some actions, but not comprehensive' anchor rather than the level above.

2 / 3

Completeness

It explicitly states both what ("Write warm, direct collaboration comments") and when via an explicit "Trigger:" clause, matching the anchor that requires explicit triggers rather than only implied timing.

3 / 3

Trigger Term Quality

"PR feedback, issue replies, reviews, Slack messages, or GitHub comments" are natural terms a user would actually say when needing this skill, giving good coverage rather than just 'some relevant keywords'.

3 / 3

Distinctiveness Conflict Risk

The comment-writing voice niche (warm, direct, for human readers) with distinct comment-context triggers is unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Gentleman-Programming/gentle-ai
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.