CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

changeset

Write and verify package release changesets, registry changelog entries, and the PR’s managed auto-release choice. Use before deciding whether a package edit needs a changeset, including skipping one.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 wrong/correct examples, exact paths and package names, a strong release-baseline decision rule, and a properly delegated registry reference. The main weaknesses are mild — some duplicated guidance between rule 3 and the Style section, and a decision flow that is spread across numbered rules rather than presented as one ordered procedure.

Suggestions

Deduplicate the guidance repeated between rule 3 and the Style section (e.g., 'implementation diary' and 'user impact only' appear in both) to tighten the token budget.

Consider a short ordered decision sequence (package-only → registry-only → mixed → no user-visible delta) that consolidates rules 1-4 into one navigable flow, ending with a re-read of the written changeset against the baseline question as a final verification step.

DimensionReasoningScore

Conciseness

The body is dense, repo-specific decision policy with no explanation of concepts Claude already knows, and concrete wrong/correct examples earn their tokens. It is a 4 rather than 5 because rule 3 restates the baseline principle multiple times ('Write changesets for the user-visible delta from the release baseline' repeats the section's opening guidance), and the 'implementation diary' / 'user impact only' prohibition appears in both rule 3's don't-list and the Style section.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready: exact package names to patch-not-minor, changeset file paths ('.changeset/plate-fix-types.md'), frontmatter examples in wrong/correct pairs, a complete breaking-change template, and named owner scripts/workflows ('tooling/scripts/auto-release-pr.mjs', '.github/workflows/changeset-auto-release.yml'). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Rules are numbered and logically ordered, with a genuine validation checkpoint ('What will a user upgrading from the release baseline observe?') and a pre-write existence check ('check whether any named removed/renamed API actually exists in the baseline'). It is a 4 rather than 5 because the decision flow (package-only vs registry-only vs mixed vs none) is distributed across rules rather than given as one explicit sequence, and there is no final verification step for the written changeset.

4 / 5

Progressive Disclosure

The body keeps core changeset policy inline and delegates registry specifics to a real, one-level-deep reference that is clearly signaled twice ('[registry changelog entries](./references/registry.md)' and '[registry reference](./references/registry.md)'); the referenced file exists and holds the registry details appropriately. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

18

/

20

Passed

Description

92%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 names three concrete artifact types (package changesets, registry changelog entries, auto-release choice) and provides an explicit 'Use before...' trigger clause that even covers the skip case. Third-person voice is used correctly and there is no padding. The only improvement would be adding a few more natural synonyms such as 'release notes' or the '.changeset' directory.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Write and verify package release changesets, registry changelog entries, and the PR's managed auto-release choice' — covering all three artifact types the skill manages, with no vague filler. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it is not a 4 because there is no noticeable gap in the skill's declared scope.

5 / 5

Completeness

Both what and when are explicit: the what is 'Write and verify package release changesets, registry changelog entries, and the PR's managed auto-release choice', and the when is the explicit trigger clause 'Use before deciding whether a package edit needs a changeset, including skipping one'. This clearly matches the 5 anchor ('Clearly and explicitly answers both what AND when with concrete trigger phrases') rather than the 4 anchor where the 'when' is only weakly specified.

5 / 5

Trigger Term Quality

Natural terms present include 'changeset', 'package release', 'changelog', 'auto-release', and 'package edit', which a user would plausibly say. It falls short of the 5 anchor ('comprehensive coverage including synonyms and file extensions') because common synonyms like 'release notes', 'version bump', and the '.changeset' directory path are absent.

4 / 5

Distinctiveness Conflict Risk

The changeset/registry-changelog/auto-release niche is distinct with specific trigger terms, so it is unlikely to fire for unrelated skills. It matches 'Clear niche with distinct triggers; minimal conflict risk'; there is no meaningful overlap with a generic skill description.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/changeset/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.