CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-notes-generator

Generate release notes in 3 formats (CHANGELOG.md, PR body, Slack announcement) from git commits. Automatically categorizes changes and converts technical language to user-friendly messaging. Use for releases, changelogs, version notes, what's new summaries, or ship announcements.

Quality

87%

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

75%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.

A highly actionable skill with concrete commands, exact templates, and a clear multi-step workflow including a migration alert checkpoint and preview mode. The main weaknesses are token duplication — the migration alert box repeated in full and an inline CHANGELOG template that duplicates the asset file — and a review-before-publish checkpoint that is relegated to Tips rather than embedded in the workflow.

Suggestions

Show the migration-alert box once (in the Console output format section) and have the Example reference it ('display the migration alert as shown above') instead of repeating the full ASCII box.

Replace the inline 'CHANGELOG.md Section' format block with a pointer to assets/changelog-template.md, keeping only one sample entry inline — the asset already contains the full template.

Promote 'Review generated content before publishing' from a Tip into an explicit numbered workflow step (generate -> review with user -> only then write files / create PR / tag), adding the missing feedback-loop checkpoint.

DimensionReasoningScore

Conciseness

The body is dense with skill-specific knowledge and never re-teaches concepts Claude already knows, but it carries real duplication: the migration-alert ASCII box is printed in full twice (Console output format and Example sections), and the ~30-line inline CHANGELOG format template substantially duplicates assets/changelog-template.md. This is more than the 'minor instances' of the score-4 anchor but well short of the pervasive padding of score 2.

3 / 5

Actionability

The skill provides copy-paste-ready commands ('git tag --sort=-v:refname | head -n 1', 'git log <tag>..HEAD --oneline --no-merges', 'gh api repos/{owner}/{repo}/pulls/{number}', 'git diff <last-tag>..HEAD --name-only -- migrations/'), exact output templates for all three formats, a worked example with invocation phrases, and concrete transformation/category tables. The remaining placeholders ([migration-command], {owner}/{repo}) are inherently repo-specific rather than gaps in guidance.

5 / 5

Workflow Clarity

Two clear numbered sequences (6-step workflow and 7-step release integration) with checkpoints present: an explicit migration-detection command with a CRITICAL alert, a preview-only mode, and a 'Write to files?' confirmation gate in the example. It falls short of score 5 because 'Review generated content before publishing' lives only in Tips rather than embedded as a workflow validation step with a review-fix-retry feedback loop.

4 / 5

Progressive Disclosure

A dedicated 'Reference files' section clearly signals one-level-deep references, and all four referenced paths (assets/changelog-template.md, assets/slack-template.md, references/tech-to-product-mappings.md, references/commit-categories.md) exist in the bundle. However, the body inlines condensed duplicates of the CHANGELOG asset template and of both reference tables, so content is not fully 'appropriately split' as the score-5 anchor requires — the duplication is a moderate organization gap, though references are far better signaled than the score-3 anchor describes.

4 / 5

Total

16

/

20

Passed

Description

96%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.

A strong description: it states concrete capabilities in third person, identifies the input source and all three output formats, and closes with an explicit 'Use for' clause rich in natural trigger synonyms. The only weakness is minor overlap risk with a generic changelog skill via the 'changelogs' trigger term.

DimensionReasoningScore

Specificity

The description names the source ('from git commits'), the three concrete output formats ('CHANGELOG.md, PR body, Slack announcement'), and two specific processing actions ('categorizes changes and converts technical language to user-friendly messaging'). This matches the anchor for multiple specific concrete actions with comprehensive coverage; it exceeds the score-4 anchor, whose 'minor gaps in coverage' do not apply here.

5 / 5

Completeness

The 'what' is explicit (generate release notes in 3 named formats from git commits, with categorization and language transformation) and the 'when' is an explicit 'Use for...' clause with concrete trigger phrases. This directly matches the score-5 anchor; the score-4 anchor's 'when could be more explicit' does not apply since the trigger list is concrete and varied.

5 / 5

Trigger Term Quality

'Use for releases, changelogs, version notes, what's new summaries, or ship announcements' covers natural synonyms and casual phrasing users would actually say, including informal variants like 'ship announcements' and "what's new summaries". This exceeds the score-4 anchor ('a few natural terms missing') and matches the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct (release notes derived from git commits in three named formats), but listing 'changelogs' as a trigger creates minor overlap risk with a closely related generic changelog skill — fitting the 'mostly distinct; minor overlap risk' anchor. It is not score 5 because a plain 'update the changelog' request could ambiguously trigger either skill.

4 / 5

Total

19

/

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

FlorianBruniaux/claude-code-ultimate-guide

Path

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