CtrlK
BlogDocsLog inGet started
Tessl Logo

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`.

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

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.

A high-quality operational skill: fully executable commands, strict validation gates at every risky step, and clear sequencing across the two execution modes (local vs GitHub Actions). The main improvement opportunity is moving the downstream CI-chain background and the release-note template into a reference file to slim the always-loaded body.

DimensionReasoningScore

Conciseness

The body is dense operational procedure with essentially no explanation of concepts Claude already knows — commands, regexes, and scripts are stated without padding. It is not a 5 because the "CI Trigger Chain" section is multi-clause background prose about downstream workflows that is not needed while executing Steps 1–6, and validation conditions are restated across Steps 1, 4, and 6, so some tightening or offloading is possible.

4 / 5

Actionability

Guidance is fully executable: exact bash snippets (git fetch/rev-parse checks, `gh release list` jq pipelines), strict semver regexes, named repo scripts (`node scripts/release/sync-release-history.js --target-version {version}`, `validate-prepared-release.js`), and a copy-paste-ready branch-creation block with placeholders. This matches the anchor for copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

Steps 1–6 are clearly sequenced with validation checkpoints throughout: pre-flight checks that "Stop before editing files if any check fails", a `--dry-run` gate, an explicit user-confirmation checkpoint before branch creation, re-validation of the baseline immediately before Step 6, and post-commit verification of the GPG signature and sign-off. This matches the anchor for explicit validation steps with feedback loops and stop conditions.

5 / 5

Progressive Disclosure

The single file is well organized with clear, navigable section headers and the core procedure legitimately belongs in SKILL.md. It is not a 5: the skill is ~205 lines, and background material not needed during execution — the CI Trigger Chain narrative and the full bilingual release-note template — is inlined rather than split into a reference file. It is not a 3: the structure is good, content is mostly appropriately placed, and nothing is buried or hard to navigate.

4 / 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 four concrete capabilities and gives an explicit, natural-language trigger clause with a slash-command synonym. The only gap is a handful of missing synonyms (e.g., "release notes", "publish") that would push trigger coverage to comprehensive.

DimensionReasoningScore

Specificity

Quotes four concrete, non-overlapping actions — "collecting commits", "generating bilingual release notes", "updating version files", "creating a release branch" — which comprehensively cover the skill's workflow. This matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require noticeable coverage gaps, and none are apparent.

5 / 5

Completeness

Clearly answers 'what' ("Prepare a new release by collecting commits, generating bilingual release notes, updating version files, and creating a release branch") and 'when' with concrete trigger phrases ("Use when asked to prepare/create a release, bump version, or run `/prepare-release`"). This matches the anchor that explicitly answers both what AND when with concrete triggers, so a 4's caveat about a weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Natural phrases "prepare/create a release", "bump version", and the explicit "/prepare-release" command are terms users would actually say. A few natural synonyms are missing (e.g., "release notes", "publish a release", "cut a release"), which fits the anchor for good keyword coverage with a few natural terms missing rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The release-preparation niche is clear and its triggers ("prepare/create a release", "bump version", "/prepare-release") are distinct; the explicit slash-command trigger minimizes conflict. It is not a 4: no closely related skill is plausibly mis-triggered by these phrases — "bump version" is generic in the abstract but here is anchored to the full release workflow.

5 / 5

Total

19

/

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