CtrlK
BlogDocsLog inGet started
Tessl Logo

vscode-release-notes-writer

Guidelines for writing and reviewing Insiders and Stable release notes for Visual Studio Code.

52

Quality

57%

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

Fix and improve this skill with Tessl

tessl review fix ./bundled/skills/vscode-release-notes-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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 with concrete commands, clear sequencing, and explicit input-validation gates, but it suffers from duplicated section descriptions and abstract subagent-delegation steps without output feedback loops. Tightening the repetition and specifying the subagent sub-tasks would raise conciseness, actionability, and workflow clarity.

Suggestions

Remove the verbatim duplication of the Insiders/Stable type descriptions (currently stated in both the intro list and each section opener) and fix the 'intially' typo.

Replace the abstract 'run a subagent to update the release notes and TOC with a concise technically accurate summary' with explicit subagent instructions (what to extract, summary length, link format, TOC update rule).

Add an output validation/review checkpoint for the Insiders batch flow, e.g. 'After updating, verify each H2 section matches a closed date and each summary links to its GH issue; fix gaps before finalizing.'

DimensionReasoningScore

Conciseness

The body is mostly lean and avoids explaining concepts Claude already knows, but the Insiders and Stable type descriptions are stated twice (lines 11/26 and 13/69, the latter with a duplicated 'intially' typo), which is unnecessary repetition, fitting the score-2 anchor 'Mostly efficient but includes some unnecessary explanation or could be tightened.' It is not score 3 because of the verbatim duplication; not score 1 because there is no padding about what VS Code or release notes are.

2 / 3

Actionability

It provides a concrete, executable command ('gh search issues --repo microsoft/vscode ...') and exact file/path formats ('v<version>.md', '1_110', image filenames), but core steps delegate abstractly to 'run a subagent to update the release notes and TOC with a concise technically accurate summary,' which is incomplete guidance, matching the score-2 anchor 'Some concrete guidance but incomplete... missing key details.' It is not score 3 because the subagent steps are not copy-paste ready; not score 1 because real executable commands and naming conventions are present.

2 / 3

Workflow Clarity

Both flows are clearly numbered and sequenced with explicit input-validation gates ('DO NOT continue until you have the release version and milestone name!!'), but the Insiders batch process (fetching many issues via subagents and updating notes) has no validate-fix-retry feedback loop on its output, so per the scoring notes workflow_clarity is capped at 2. It is not score 3 because output validation/error-recovery loops are missing for the batch operation; not score 1 because the sequence and input checkpoints are explicit.

2 / 3

Progressive Disclosure

The body is organized into a clear overview plus well-separated Insiders and Stable sections (each with Input parameters, File format, Generation steps) and uses clearly signaled, one-level-deep markdown links to templates and examples (e.g. 'template-release-note-insiders.md', './examples/v1_109.md'), matching the score-3 anchor 'Clear overview with well-signaled one-level-deep references... easy navigation.' It is not score 2 because references are explicitly signaled rather than buried and there is no nested reference chain; it would drop only if the referenced bundle files were missing or nested deeper.

3 / 3

Total

9

/

12

Passed

Description

57%

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 states a clear, distinctive niche (VS Code release notes for Insiders and Stable) but is generic in its action verbs and entirely lacks a 'Use when...' trigger clause. Adding explicit trigger guidance and more concrete verbs would lift the completeness and trigger-term dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing or reviewing VS Code Insiders or Stable release notes, or when the user asks to generate release notes for a VS Code milestone.'

Expand the action verbs beyond 'writing and reviewing' to concrete steps such as 'generate release notes from closed GitHub issues and PRs, group issues by closed date, and update the TOC.'

Include the common abbreviation 'VS Code' alongside 'Visual Studio Code' so the description matches natural user phrasing.

DimensionReasoningScore

Specificity

Names the domain ('Visual Studio Code' release notes) and two artifact types ('Insiders and Stable') with two actions ('writing and reviewing'), but stops at generic verbs rather than listing multiple concrete actions, matching the score-2 anchor 'Names domain and some actions, but not comprehensive.' It is not score 3 because there are no enumerated specific actions like 'extract,' 'fill,' 'merge'; it is not score 1 because it does name concrete actions beyond vague help.

2 / 3

Completeness

It answers 'what' ('writing and reviewing Insiders and Stable release notes for Visual Studio Code') but provides no 'when' — there is no 'Use when...' clause or equivalent trigger guidance, so per the judging guidelines completeness is capped at 2 ('Has what, but when is missing or only implied'). It is not score 3 because the when is entirely absent; not score 1 because the what is clearly stated.

2 / 3

Trigger Term Quality

It includes relevant natural terms ('release notes', 'Visual Studio Code') but omits common variations a user would say ('VS Code', 'Insiders build') and lacks a 'Use when...' trigger clause, fitting the score-2 anchor 'Some relevant keywords but missing common variations.' It is not score 3 due to the missing variations and absence of explicit trigger phrasing; not score 1 because the keywords present are natural rather than jargon.

2 / 3

Distinctiveness Conflict Risk

'Visual Studio Code release notes' is a product- and artifact-specific niche that is clearly distinguishable and unlikely to trigger for the wrong skill, matching the score-3 anchor 'Clear niche with distinct triggers; unlikely to conflict.' It is not score 2 because it is far more specific than 'Works with document files'; not below 3 because the product scope makes conflict with other skills low.

3 / 3

Total

9

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing, 2 suspicious

Warning

Total

15

/

16

Passed

Repository
foryourhealth111-pixel/Vibe-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.