CtrlK
BlogDocsLog inGet started
Tessl Logo

changeset

Command: changeset

52

Quality

58%

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

85%

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 well-structured, highly actionable guide with concrete templates, wrong/correct examples, and a validation checklist, only mildly held back by repetition in the 'relative to main' section.

DimensionReasoningScore

Conciseness

The body is largely lean and assumes Claude's competence, but section 3 re-explains the 'relative to main' rule across prose, a 'That means:' list, a 'Do not write:' list, and the Red Flags checklist, which could be tightened.

2 / 3

Actionability

It provides concrete wrong/correct YAML frontmatter examples, executable registry bash commands, and copy-paste-ready templates (simple, API, breaking) with before/after code.

3 / 3

Workflow Clarity

For a single-purpose writing skill it gives a clear When To Use section, sequenced Critical Rules, and a pre-ship Red Flags checklist that serves as an explicit validation checkpoint.

3 / 3

Progressive Disclosure

No bundle files are needed; the single SKILL.md is well-organized into clear sections and appropriately defers registry detail to the registry-changelog skill rather than duplicating its schema.

3 / 3

Total

11

/

12

Passed

Description

32%

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 is a terse two-word label that names a domain but describes no concrete actions and gives no usage triggers, leaving both what and when largely unstated.

Suggestions

Add concrete capability actions, e.g. 'Write and format .changeset/*.md files documenting package changes for release'.

Add an explicit 'Use when...' clause covering natural triggers like creating changesets, preparing release notes, or bumping package versions.

Disambiguate from the registry-changelog skill, e.g. 'Use for package changesets; use registry-changelog for apps/www/src/registry entries'.

DimensionReasoningScore

Specificity

The description 'Command: changeset' names a concrete, specific domain (changesets) but states no capability actions at all, so it is more specific than 'Helps with documents' yet far short of listing concrete actions.

2 / 3

Completeness

It does not explicitly describe what the skill does (no action verbs) and provides no 'Use when...' trigger guidance, so both what and when are very weak.

1 / 3

Trigger Term Quality

'changeset' is a natural term a developer would actually say, but coverage is thin with no common variations like 'release notes', 'version bump', or 'changelog'.

2 / 3

Distinctiveness Conflict Risk

'changeset' points to a fairly distinct niche, but the bare label gives no trigger distinction from the related registry-changelog/changelog territory, so overlap risk remains.

2 / 3

Total

7

/

12

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.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

description_field

'description' is very short (18 chars), consider making it more detailed

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.