CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

changeset

Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail

56

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/changeset/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

The body is a lean, concrete, well-sequenced process guide with exact commands, package mappings, paths, and format rules — no filler or over-explanation. Its weaknesses are the absence of validation checkpoints for its batch operations (capping workflow clarity at 3) and the lack of a complete example changeset to make the format guidance fully copy-paste ready.

Suggestions

Add a validation checkpoint after step 3 — e.g. run `yarn changeset status` to confirm all intended changesets exist before moving on — since batch operations without feedback loops cap workflow clarity at 3.

Include one complete example changeset (action-verb title line, user-outcome body, `BREAKING:` prefix where applicable) so the format rules are copy-paste ready.

Merge the overlapping guidance in 'Writing perspective' with items 1–2 of 'Changeset body quality' to remove redundant tokens.

DimensionReasoningScore

Conciseness

The body is imperative, dense, and explains nothing Claude already knows — commands and paths are given bare ("Run `yarn changeset` once per distinct change"). It sits at anchor 4 (efficient, minor trims): "Writing perspective" ("Avoid internal names ... changeset bodies are for consumers") overlaps items 1–2 of "Changeset body quality". Not 5 because that overlap could be merged; not 3 because there is no genuinely unnecessary explanation.

4 / 5

Actionability

Concrete, executable guidance throughout: exact command ("Run `yarn changeset`"), explicit package mapping ("`@data-client/endpoint` → also select `@data-client/rest`, `@data-client/graphql`"), exact paths ("`.cursor/rules/breaking-changes.mdc`", "`no-agent-impact.json`"), and precise format rules ("Prefix with `BREAKING CHANGE:` or `BREAKING:`"). Anchor 4 fits: minor gap — no complete example changeset making the format rules copy-paste ready. Not 3 (guidance is executable, not pseudocode-level hints); not 5 (no end-to-end example covering common cases).

4 / 5

Workflow Clarity

The six steps are clearly sequenced (analyze → determine packages → run changesets → update docs → update blog → update skills) with sub-details, but there are no validation/verification checkpoints for what are batch operations — running changesets once per distinct change and sweeping "all usages of changed APIs across `docs/`, `packages/*/README.md`, and root `README.md`" — so the batch-operation rule caps workflow clarity at 3. Not 2 because the sequence is complete and well-defined, with no gaps between steps.

3 / 5

Progressive Disclosure

A single ~65-line file with clear section headers (Overview, Steps, Changeset body quality, Changeset format) and clearly signaled one-level-deep external references ("`.cursor/rules/markdown-formatting.mdc`", "`agent-impact-review.md`"). Anchor 4 (good structure, minor organization gaps) fits: the body exceeds the under-50-line simple-skill threshold and mixes process steps with authoring-style guidance that could be split. Not 3 because structure and reference signaling are genuinely good, not merely present.

4 / 5

Total

15

/

20

Passed

Description

61%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.

The description clearly identifies the changeset/changelog niche with strong natural trigger terms in concise third-person form, but it omits any 'Use when...' trigger clause (capping completeness) and surfaces only one of the skill's several concrete actions, leaving specificity short of comprehensive.

Suggestions

Add an explicit trigger clause, e.g. "Use when preparing a release, writing changelog entries, or handling breaking changes in this repo" — completeness is capped at 3 without one.

Surface the other concrete actions from the body (update docs, draft release blog posts, update skills) so the description covers the skill's full capability set.

DimensionReasoningScore

Specificity

"Create user-focused changesets (changelog entries)" is one concrete action, and "for semver bumps, release notes, breaking changes, and docs" names the domain objects but adds no further actions — the body's other actions (update docs, draft blog, update skills) are absent from the description. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is not 4 because it does not list several specific actions, and not 2 because it does more than the minimal 'Processes PDF files' level.

3 / 5

Completeness

The 'what' is clear ("Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs") but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because that anchor requires both 'what' and 'when'; not 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Natural phrases a user would say are present: "changelog entries", "semver bumps", "release notes", "breaking changes" — good keyword coverage matching anchor 4. Not 5 because common variations/synonyms like "version bump", "CHANGELOG.md", or "release preparation" are missing; not 3 because coverage goes beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"changesets", "changelog entries", "semver bumps", and "release notes" carve out a clear release-notes niche, matching anchor 4 (mostly distinct, minor overlap). Not 5 because "release notes" and "docs" could also match a broader documentation skill; not 3 because the niche is specific, not generically overlapping.

4 / 5

Total

14

/

20

Passed

Validation

81%

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

Validation — 13 / 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

relative_links

Relative link issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

reactive/data-client

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.