CtrlK
BlogDocsLog inGet started
Tessl Logo

changelog-generator

Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.

53

Quality

60%

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 ./skills/changelog-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 well-structured and reads quickly, with a useful example output that anchors the expected format. However, it stays at the level of description rather than instruction — no git commands, no commit-categorization rules, and no explicit validation step in the workflow — and carries a few padded sections that add tokens without adding capability.

Suggestions

Add the concrete git commands to run, e.g. `git log v2.4.0..HEAD --oneline` or `git log --since="1 week ago"`, so the scan step is executable.

Specify the commit-to-category mapping (e.g. feat → New Features, fix → Fixes, BREAKING CHANGE → Breaking Changes) and what counts as noise, instead of just naming the categories.

Trim the marketing intro, the 'Inspired by' attribution, and the 'Related Use Cases' section, and fold 'review before publishing' into the workflow as an explicit final validation step.

DimensionReasoningScore

Conciseness

Mostly efficient — sections are list-based and avoid explaining git or changelog concepts Claude already knows — but there is noticeable padding that could be tightened: the marketing intro ('polished, user-friendly changelogs that your customers and users will actually understand and appreciate'), the attribution line ('Inspired by: Manik Aggarwal's use case from Lenny's Newsletter'), and the largely redundant 'Related Use Cases' section. Not a 4 because these several unnecessary sections go beyond 'minor instances that could be trimmed'.

3 / 5

Actionability

There is some concrete guidance — example prompts ('Create a changelog for commits since v2.4.0') and a full sample output showing the desired format — but the actual execution details are missing: no git commands (e.g. `git log v2.4.0..HEAD`), no categorization rules for mapping commit types to sections, and no guidance on how noise filtering works. This matches 'some concrete guidance but incomplete; missing key details' rather than the mostly-executable level 4.

3 / 5

Workflow Clarity

The 'What This Skill Does' section provides a rough sequence (scan → categorize → translate → format → filter → follow guidelines), but steps are one-line abstractions with no checkpoints; the only validation is a buried tip ('Review and adjust the generated changelog before publishing') rather than an explicit step in the workflow. This fits 'steps listed but validation gaps; checkpoints missing or implicit' and is not a 4, which requires most checkpoints present in the sequence itself.

3 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~100-line body is well organized into clearly labeled sections (When to Use, What This Skill Does, How to Use, Example, Tips) with the example output inlined appropriately for a skill of this size. Good structure with only minor gaps (e.g. the example and category definitions could live in a reference file); it does not reach 5 because the under-50-line exception doesn't apply and content like the extended example could be split out.

4 / 5

Total

13

/

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 does a solid job on the 'what' with multiple concrete, domain-specific actions and natural keywords like 'changelog' and 'release notes'. Its main weakness is the complete absence of any 'Use when...' trigger clause, which caps completeness, and a marketing-style closing sentence that adds padding rather than information.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a changelog, release notes, or a summary of recent changes/commits.'

Replace the marketing sentence 'Turns hours of manual changelog writing into minutes of automated generation' with concrete capability or trigger information.

Broaden trigger coverage with synonyms users naturally say: 'what's new', 'version history', 'product updates'.

DimensionReasoningScore

Specificity

Quotes several concrete actions — 'analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes' — which matches the 'lists several specific actions; minor gaps' anchor. Not a 5 because the trailing marketing sentence ('Turns hours of manual changelog writing into minutes of automated generation') is padded fluff rather than an additional capability, and no output-format detail is given.

4 / 5

Completeness

The 'what' is clearly answered ('creates user-facing changelogs from git commits... transforming technical commits into customer-friendly release notes'), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere, which per the judging guidelines caps completeness at 3. It is not a 4 or 5 because the 'when' is entirely absent rather than merely implicit-but-present.

3 / 5

Trigger Term Quality

Includes strong natural terms users would say — 'changelog', 'git commits', 'commit history', 'release notes' — giving good keyword coverage per the anchor. Not a 5 because common synonyms like 'what's new', 'version history', or 'product updates' are missing, keeping it short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The changelog/release-notes-from-git niche is clear and mostly distinct ('creates user-facing changelogs from git commits... customer-friendly release notes'), matching the 'mostly distinct; minor overlap risk' anchor. Not a 5 because it could mildly overlap with commit-message-generation skills since both analyze git history, though the output artifact differs.

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
MoizIbnYousaf/ai-agent-skills
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.