CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-notes-check

Check a supplied release note for its owner, rollback note and verification step

Quality

87%

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 a lean, instruction-only skill: it scopes the input strictly, defines exact checks and output conventions including an anti-hallucination fallback, and delegates the checklist to a real, one-level-deep reference file. No changes needed.

DimensionReasoningScore

Conciseness

The body is five lean lines with zero padding and no explanation of concepts Claude already knows — "Review only the release-note text supplied by the user. Do not fetch data, run commands, or change files." Every sentence instructs, matching anchor 5 ("every token earns its place"). It is not anchor 4 because there is no over-explanation to trim.

5 / 5

Actionability

The guidance is fully executable for an instruction-only skill: it names the three exact checks ("names an owner, contains a rollback note, and states a verification step"), the evidencing rule ("Quote the supplied text for each finding"), and the exact fallback output ("write 'Not provided' rather than inventing it"). Per the scoring notes, absence of code is not penalized when guidance is this concrete, so it matches anchor 5 rather than anchor 4's "minor gaps".

5 / 5

Workflow Clarity

This is a simple single-purpose skill where the single action is unambiguous — read the supplied note, check three items, report with quotes — which the scoring notes allow to score 5. It also includes an explicit anti-hallucination checkpoint ("write 'Not provided' rather than inventing it"), so it is not anchor 4. No destructive or batch operations exist that would cap the score at 3.

5 / 5

Progressive Disclosure

The body is a clear overview with one well-signaled, one-level-deep reference ("Use the checklist in `references/checklist.md`"); the file exists in the bundle and contains the actual checklist with no nested references. This matches anchor 5; it is not anchor 4 because there are no organization gaps or buried references.

5 / 5

Total

20

/

20

Passed

Description

70%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 concise, concrete, and clearly niche-scoped, enumerating the three specific things it checks. Its main weakness is the absence of any "Use when..." trigger guidance, which caps completeness, and some natural keyword variations (plural "release notes", "changelog", "rollout") are missing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user supplies a release note, rollout note, or changelog entry to review."

Include natural keyword variations such as "release notes", "changelog", and "rollout note" so users can find the skill with the phrasings they actually say.

State the outcome in the description (e.g. "...and report each finding with quoted evidence") so the "what" covers the full action, not just the checks.

DimensionReasoningScore

Specificity

The description enumerates three concrete check targets — "its owner, rollback note and verification step" — comparable to anchor 4's list of several specific actions, with a minor gap: it never states that findings are reported. It exceeds anchor 3 (1-2 actions, not comprehensive) since the three items fully cover the check's scope, but falls short of anchor 5's comprehensive coverage because the reporting step is omitted.

4 / 5

Completeness

The "what" is clear ("Check a supplied release note for its owner, rollback note and verification step") but there is no "Use when..." clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is above anchor 2 because the "what" is concrete rather than vague, and below anchor 4 because "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural domain phrases are present — "release note", "owner", "rollback note", "verification step" — giving good keyword coverage akin to anchor 4 ("PDF files, forms, document extraction"). It is not anchor 5 because common variations like "release notes" (plural), "changelog", or "rollout note" are missing, and not anchor 3 because coverage goes beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Terms like "release note", "rollback note" and "verification step" carve out a clear niche (release-note completeness checking) with minimal conflict risk, matching anchor 5. It is not anchor 4 because the vocabulary is specific enough that closely related skills (e.g., release-note authoring) would not plausibly be triggered by this description.

5 / 5

Total

16

/

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

ascending-llc/jarvis-registry

Path

docs/walkthroughs/examples/skills/revision-2/release-notes-check/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.