CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

changelog-generator

Produce consistent, auditable release notes from Conventional Commits. Separates commit parsing, semantic-bump logic, and changelog rendering for automated releases with editorial control. Use when cutting a release, generating CHANGELOG.md from git history, computing the next semantic version from commits, automating release notes in CI, or planning a hotfix/rollback. Examples: 'generate the changelog for v1.4.0', 'what version bump do these commits require', 'we need an emergency hotfix process'.

67

Quality

84%

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

The canonical home for this skill is changelog-generator in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 unusually process-mature: concrete executable-form commands, a sequenced release-governance flow with validation gates, failure-handling recovery paths, and output quality checklists. Its critical defect is the bundle itself — every referenced reference, script, and asset file is missing, which breaks progressive disclosure entirely and leaves the script-based workflows unexecutable as shipped.

Suggestions

Ship the referenced bundle files: scripts/generate_changelog.py, scripts/version_bumper.py, scripts/commit_linter.py, the four references/*.md files, assets/sample_git_log.txt, and README.md are all currently dangling paths. Either include them in the bundle or remove the links and inline the essential content.

Until the scripts exist, add a fallback path (e.g., manual changelog-assembly and version-bump instructions) so the Key Workflows remain actionable without the missing scripts.

Trim duplication to improve token efficiency: merge 'Overview' and 'When to Use' (which restate the frontmatter description), and deduplicate overlapping items between 'Common Pitfalls' and 'Best Practices'.

DimensionReasoningScore

Conciseness

The body is mostly lean: terse command examples, compact tables, and skill-specific contracts (supported types list, failure handling) with little padding. Minor trims remain — 'Overview' and 'When to Use' restate the frontmatter description almost verbatim, 'Common Pitfalls' and 'Best Practices' overlap (commit-scoping advice appears in both), and the SemVer mapping ('breaking -> major, non-breaking feat -> minor') restates knowledge Claude already has. That matches anchor 4's 'minor instances of over-explanation that could be trimmed', clearly above anchor 3.

4 / 5

Actionability

Guidance is concrete and command-level: 'python3 scripts/generate_changelog.py --from-tag v1.3.0 --to-tag v1.4.0 --next-version v1.4.0 --format markdown', 'python3 scripts/commit_linter.py --from-ref origin/main --to-ref HEAD --strict --format text', with documented output fields ('recommended_version', 'bump_type') and input format specifics (real 'git log --oneline' output, hex hashes). However, none of the invoked scripts (scripts/generate_changelog.py, scripts/version_bumper.py, scripts/commit_linter.py) exist in the bundle, so the commands are not executable as shipped — a real gap that keeps this at anchor 4's 'mostly executable' rather than anchor 5's copy-paste-ready.

4 / 5

Workflow Clarity

'Release Governance' sequences the full flow with explicit gates: '1. Lint commit history... 4. Validate semver bump recommendation. 5. Tag release only after changelog is approved', backed by a machine check ('Returns non-zero in --strict mode on violations') and 'Tag releases only after changelog generation succeeds'. 'Failure Handling' supplies error-recovery paths ('If git range invalid: surface explicit range in error output'; 'fail early, do not generate misleading empty notes') and 'Output Quality Checks' is a checklist — anchor 5's explicit validation, feedback loops, and checklist pattern. Validation is present throughout, so the destructive/batch cap at 3 does not apply.

5 / 5

Progressive Disclosure

References are well signaled and one level deep ('full procedures in references/hotfix-procedures.md', a References section listing four links), but scoring against the actual bundle structure, none of the referenced files exist: references/, scripts/, and assets/ are absent, so all five referenced paths (including README.md) and all three scripts dangle. No content is actually split across files and every navigation target is broken — effectively content that belongs in separate files is inlined in a single SKILL.md with dead links, matching anchor 2. It is not anchor 1 (in-file structure and signaling are good, nothing is nested 2+ levels), but clearly below anchor 3, where references at least exist.

2 / 5

Total

15

/

20

Passed

Description

91%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 in third-person voice: it concretely states what the skill does, explicitly says when to use it, and covers natural trigger terms including synonyms, a file name, and example user phrasings. Only minor gaps remain: the commit-linting capability is unmentioned and the hotfix/rollback territory slightly overlaps adjacent skills.

DimensionReasoningScore

Specificity

Concrete actions are named: 'Produce consistent, auditable release notes from Conventional Commits', 'Separates commit parsing, semantic-bump logic, and changelog rendering', and 'computing the next semantic version from commits'. This is several specific actions rather than anchor 3's 1-2, but the body's linting capability ('Enforce commit format with a dedicated linter script') is unmentioned, leaving the minor coverage gap that defines anchor 4 rather than 5's comprehensive coverage.

4 / 5

Completeness

What is answered concretely ('Produce consistent, auditable release notes from Conventional Commits...') and when is explicit with concrete triggers ('Use when cutting a release, generating CHANGELOG.md from git history, computing the next semantic version from commits, automating release notes in CI, or planning a hotfix/rollback') plus example phrases — the exact pattern of anchor 5, well above anchor 4's 'when could be more explicit'.

5 / 5

Trigger Term Quality

Natural terms cover synonyms and file names: 'changelog'/'release notes', 'CHANGELOG.md', 'version bump'/'semantic version', 'hotfix'/'rollback', 'Conventional Commits', 'v1.4.0', 'CI'. Quoted example phrases ('generate the changelog for v1.4.0', 'what version bump do these commits require', 'we need an emergency hotfix process') are utterances a user would naturally say, matching anchor 5's comprehensive synonym coverage; no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

'Conventional Commits' and 'CHANGELOG.md' mark a clear niche, but 'planning a hotfix/rollback' overlaps incident-response/deployment skills and version-bump computation sits adjacent to commit-message tooling in the same git-commit space. That is anchor 4's 'minor overlap risk with closely related skills' rather than anchor 5's minimal conflict risk.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 missing

Warning

referenced_paths_exist

Referenced path issues: 23 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/changelog-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.