CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-notes

Generate release notes between two git tags with categorized PR summaries and author attribution

Quality

81%

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

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.

An exemplary instruction-only skill: fully executable git/gh commands, an explicitly sequenced 9-step workflow with validation checkpoints and a user-approval feedback loop before any file write, and lean prose with almost no padding. The only structural improvement would be splitting the output template/categorization rules into a reference file as the skill grows.

DimensionReasoningScore

Conciseness

Efficient throughout: bare executable git/gh commands with no explanation of concepts Claude already knows, no conceptual padding, and a tight output template. Not 5: a few judgment-call sentences ('Use judgment: not every feature is a highlight... A highlight should be something users would be excited about') could be tightened.

4 / 5

Actionability

Every step ships copy-paste-ready commands with exact flags and JSON field lists — 'git tag --sort=-v:refname', 'git log --oneline LOWER..TAG', 'gh pr view NUMBER --repo dlt-hub/dlt --json number,title,labels,body,author', plus fallbacks ('gh issue view', 'gh pr diff') for low-quality titles. Fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Nine explicitly numbered steps with a clear sequence and real validation checkpoints: tag-existence check with a specific error-and-stop message, LOWER validation, a 'no PR may be silently dropped / total count must match' invariant, and an approval gate with a revise loop before writing the file — exactly the validate-then-proceed pattern the top anchor describes.

5 / 5

Progressive Disclosure

A single well-sectioned file with clear step headings and no buried references — no bundle files exist, so nothing is misplaced. Not 5: at ~180 lines it exceeds the simple-skill case, and the exact output template plus the categorization rules could arguably live in a one-level-deep reference file; structure is nonetheless easy to navigate.

4 / 5

Total

18

/

20

Passed

Description

66%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 gives a clear, specific 'what' with concrete capability nouns and is firmly distinct from other skills, but it entirely lacks a 'Use when...' trigger clause, which caps completeness and slightly weakens trigger discoverability. Adding an explicit trigger sentence with synonyms like 'changelog' would move it to the top anchors.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user asks for release notes, a changelog, or a summary of changes between two tags/versions.'

Include common synonyms such as 'changelog' or 'version summary' among the trigger terms to broaden natural-keyword coverage.

Optionally mention new-contributor identification, a concrete output capability the body implements but the description omits.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Generate release notes between two git tags', 'categorized PR summaries', 'author attribution' — matching the anchor for several specific actions with minor gaps. Not 5: coverage omits capabilities present in the body (new-contributor detection, changelog output); not 3: more than 1-2 concrete actions are named.

4 / 5

Completeness

Has a clear 'what' ('Generate release notes between two git tags with categorized PR summaries and author attribution') but no 'Use when...' clause or equivalent explicit trigger guidance. Per judging guidelines, a missing 'when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

'release notes', 'git tags', and 'PR' are natural phrases a user would say when needing this skill. Not 5: common synonyms like 'changelog' or 'version notes' are absent; not 3: the core natural terms users actually say are all present.

4 / 5

Distinctiveness Conflict Risk

A distinct niche — generating release notes between two git tags — unlikely to fire for unrelated skills, with only minor overlap risk with adjacent git-workflow skills (e.g., commit message generation). Not 5: triggers are not spelled out to fully disambiguate.

4 / 5

Total

15

/

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

dlt-hub/dlt

Path

.claude/skills/release-notes/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.