CtrlK
BlogDocsLog inGet started
Tessl Logo

skillshare-changelog

Generate CHANGELOG.md entry from recent commits in conventional format. Also syncs the website changelog page. Use this skill whenever the user asks to: write release notes, generate a changelog, prepare a version release, document what changed between tags, or create a new CHANGELOG entry. If you see requests like "write the changelog for v0.17", "what changed since last release", or "prepare release notes", this is the skill to use. Do NOT manually edit CHANGELOG.md without this skill — it ensures proper formatting, user-perspective writing, and website changelog sync.

90

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It provides specific actions, comprehensive trigger terms with real-world examples, explicit 'Use when' guidance, and a clear distinctive niche. The additional guidance about not manually editing CHANGELOG.md reinforces when this skill should be selected.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'Generate CHANGELOG.md entry', 'syncs the website changelog page', 'ensures proper formatting, user-perspective writing, and website changelog sync'. Clear about what it does with specific outputs.

3 / 3

Completeness

Clearly answers both what ('Generate CHANGELOG.md entry from recent commits, syncs website changelog') and when ('Use this skill whenever the user asks to: write release notes, generate a changelog...'). Includes explicit 'Use when' clause with multiple trigger scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'release notes', 'changelog', 'version release', 'document what changed', 'CHANGELOG entry', plus concrete examples like 'write the changelog for v0.17', 'what changed since last release', 'prepare release notes'.

3 / 3

Distinctiveness Conflict Risk

Very clear niche focused specifically on CHANGELOG generation and release notes. The explicit mention of 'CHANGELOG.md', 'conventional format', version tags, and website sync makes it highly distinguishable from general documentation or git skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, actionable skill with clear workflow steps and executable commands. The main weakness is some redundancy in style guidance between steps 5 and 6, and the skill could benefit from slightly tighter prose. The conditional maintainer logic and dual-file sync requirements are well-documented.

Suggestions

Consolidate the wording guidelines from Step 5 and style points from Step 6 into a single reference section to reduce redundancy

Consider extracting the detailed RELEASE_NOTES section to a separate file since it only applies to maintainers

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some redundancy—the wording guidelines and style points are repeated in slightly different forms across steps 5 and 6. The maintainer-only section could be more compact.

2 / 3

Actionability

Provides fully executable bash commands for version detection and commit collection, concrete markdown templates, and specific examples of good/bad wording. Copy-paste ready throughout.

3 / 3

Workflow Clarity

Clear 8-step sequence with explicit checkpoints—version detection, commit collection, categorization, style reference reading, writing, updating, syncing, and conditional release notes. The maintainer check provides a clear decision point.

3 / 3

Progressive Disclosure

Content is well-organized with clear sections, but everything is inline in one file. The RELEASE_NOTES section and detailed style guidelines could potentially be split into referenced files for better organization, though the current length is manageable.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
runkids/skillshare
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.