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
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
053ecb4
Table of Contents
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.