CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-changelog

Write a CHANGELOG.md entry for a new extension release. Use when: writing changelog, updating changelog, adding release notes, preparing a release, documenting milestone changes. Requires a milestone name and extension version number.

Quality

83%

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

82%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 well-crafted, highly actionable skill body: concrete search queries, a clear classification scheme, an exact output template, and a validation step. Minor gaps are the unspecified search tooling and the absence of an error-recovery loop after validation.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: verbatim search queries ('milestone:"<name>" repo:microsoft/vscode-pull-request-github is:closed'), a compact classification table, and a fill-in template. There is no padding or explanation of concepts Claude already knows; every token earns its place.

5 / 5

Actionability

Concrete, executable guidance throughout: exact search query strings, a bucket-classification table, a copy-paste markdown template with placeholder URLs, and explicit format rules. It falls just short of anchor 5 because the search mechanism (gh CLI vs. web search) is left implicit and issue-title cleanup is not specified.

4 / 5

Workflow Clarity

A clear four-step sequence (Gather → Classify → Write → Validate) with an explicit final validation checklist (positioning, link correctness, duplicates). Not anchor 5: there is no error-recovery feedback loop (e.g. what to do if validation fails). The batch-edit cap of 3 does not apply since validation steps are present.

4 / 5

Progressive Disclosure

Well-organized single-file structure (Inputs, numbered Procedure, Format Rules, Validate) with a table and template, and no nested or buried references. At ~68 body lines it exceeds the under-50-line exception that would allow a 5 without external references, matching anchor 4's 'good structure, minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

78%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 clearly states what the skill does, gives explicit 'Use when' triggers with good synonym coverage, and names required inputs. Slight room to grow in breadth of capability description and trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action ('Write a CHANGELOG.md entry for a new extension release') but does not list several specific actions, matching the 1-2 concrete actions anchor. It is more concrete than the generic anchor 2, but lacks the multi-action coverage of anchor 4.

3 / 5

Completeness

It explicitly answers both 'what' (write a CHANGELOG.md entry for an extension release) and 'when' ('Use when: writing changelog, updating changelog, adding release notes, preparing a release, documenting milestone changes') with concrete trigger phrases, plus required inputs ('Requires a milestone name and extension version number'). This matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Triggers cover natural phrases users would say: 'writing changelog, updating changelog, adding release notes, preparing a release, documenting milestone changes' — good synonym coverage. A few natural terms (e.g. 'version bump', 'tagging a release') are missing, keeping it below comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Milestone-driven changelog generation is a distinct niche with specific triggers, but 'preparing a release' and 'adding release notes' carry minor overlap with generic release-prep or release-notes skills. Mostly distinct with minor overlap risk, matching anchor 4 rather than the clear-niche anchor 5.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

microsoft/vscode-pull-request-github

Path

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