CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prepare-release

Prepare a new release by collecting commits, generating bilingual release notes, updating version files, and creating a release branch. Use when asked to prepare/create a release, bump version, or run `/prepare-release`.

Quality

90%

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

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

An exceptionally actionable and well-guarded release runbook: every step carries executable commands, exact formats, stop conditions, and revalidation before irreversible actions. The only friction is stylistic — run-on CI-chain prose and one duplicated command — and the lack of any bundle files for background material.

DimensionReasoningScore

Conciseness

The body is a dense, repo-specific runbook that assumes Claude's competence — it explains no general concepts (no semver or git tutorials) and nearly every line encodes a non-obvious project rule. It falls short of anchor 5 because the CI Trigger Chain section uses long run-on paragraphs and the 'gh release list' jq command is repeated verbatim in Steps 1 and 6, both of which could be tightened.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready bash blocks with placeholders ('git checkout -b release/v{version}', 'git commit -S --signoff -m "chore(release): prepare v{version}"'), exact semver regexes, exact script invocations ('node scripts/release/sync-release-history.js --target-version {version}'), and a concrete bilingual release-note template. Specific commands cover the common cases.

5 / 5

Workflow Clarity

A clearly sequenced six-step workflow with explicit validation checkpoints and feedback loops: pre-flight checkout validation ('Stop before editing files if any check fails'), a validator script in Step 4 ('stop if it rejects'), user confirmation in Step 5, and a full revalidation suite in Step 6 (baseline re-match, allowed-paths check, signature/DCO verification). This matches the anchor with explicit validation steps and error-recovery guidance.

5 / 5

Progressive Disclosure

Good section structure (Arguments, Workflow with six steps, CI Trigger Chain, Constraints) with all guidance at one level and no nested or dead references — verified there are no references/, scripts/, or assets/ bundle files. It stops short of anchor 5 because a few borderline-externalizable sections (the CI Trigger Chain and backport-workflow narrative) are inlined in a ~217-line file where a separate reference file could keep SKILL.md as a tighter overview.

4 / 5

Total

18

/

20

Passed

Description

88%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 that pairs a concrete multi-action capability statement with an explicit 'Use when' trigger clause in third person. Trigger coverage is good though missing a few natural synonyms, and the generic 'bump version' phrasing leaves minor conflict risk with generic versioning skills.

DimensionReasoningScore

Specificity

Lists four concrete, specific actions — 'collecting commits, generating bilingual release notes, updating version files, and creating a release branch' — covering the full release-preparation workflow comprehensively. This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor with coverage gaps.

5 / 5

Completeness

Explicitly answers what ('Prepare a new release by collecting commits, generating bilingual release notes, updating version files, and creating a release branch') and when ('Use when asked to prepare/create a release, bump version, or run /prepare-release') with concrete trigger phrases, matching the anchor 5 example structure exactly.

5 / 5

Trigger Term Quality

Natural phrases like 'prepare/create a release', 'bump version', and the '/prepare-release' slash command are present, but common synonyms users might say ('new version', 'release notes', 'cut/publish a release') are missing. Good keyword coverage with a few natural terms missing fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The bilingual-notes and release-branch actions plus the '/prepare-release' command make the skill mostly distinct, but 'bump version' and 'prepare a release' are generic phrases that overlap generic versioning/release skills, and no product name anchors the niche. Minor overlap risk with closely related skills fits anchor 4 rather than the clear-niche minimal-conflict profile of anchor 5.

4 / 5

Total

18

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 3 missing, 3 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

CherryHQ/cherry-studio

Path

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