CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mflux-release

Prepare a release in mflux (version bump + uv lock; release notes are harvested from PR release-note blocks and live in GitHub Releases). Use when preparing a release branch or release PR.

Quality

91%

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

100%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 exemplary repo-process skill: lean, dense with non-obvious specifics, and fully executable. It clearly separates the automated CI side (tagging/publishing, note harvesting) from the human/Claude prep tasks, and closes with a guardrail against the one risky manual action (local tagging).

DimensionReasoningScore

Conciseness

Every line carries repo-specific knowledge Claude could not infer — 'the ungated `draft-notes` job', 'gated job publishes it exactly as edited', 'Give the PR the `chore` label' — with no padding or explanation of concepts Claude already knows. The 'How notes work now (#685)' section is exactly the non-obvious context the skill exists to convey.

5 / 5

Actionability

The checklist is copy-paste executable: 'Bump version in `pyproject.toml`', 'Update lockfile: `uv lock`', 'Sanity checks (optional unless requested): `just test-fast`, `just build`', plus a concrete commit format 'release: prepare <version>' and an example release note. No pseudocode or vague direction anywhere.

5 / 5

Workflow Clarity

The checklist gives a clear ordered sequence with explicit validation commands (`just test-fast`, `just build`) and a guardrail ('Do not tag releases locally unless explicitly requested'). The notes section includes a recovery loop ('A re-dispatch never overwrites an existing draft; delete the draft to re-harvest'). This is a simple single-purpose skill and the task is unambiguous; the operation is neither destructive nor batch, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The body is under 50 lines with two well-organized sections ('How notes work now (#685)', 'Release-prep PR checklist') and no need for external reference files. Per the rubric's simple-skill guideline, this earns full credit with well-organized sections alone.

5 / 5

Total

20

/

20

Passed

Description

78%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: concrete, correctly voiced, and explicitly scoped to the mflux repo with both a what and a when clause. It falls just short of the top anchors on trigger breadth and action coverage — the when-clause covers only 'release branch or release PR' phrasings and omits natural variations users might say.

Suggestions

Broaden the 'Use when' clause with trigger variations users naturally say, e.g. 'Use when preparing a release branch or release PR, cutting a release, or bumping the version for a release.'

Name the remaining prep actions in the description so coverage is comprehensive, e.g. appending 'including the release-note block, chore label, and release commit' to the action list.

Consider mentioning the sanity-check commands (`just test-fast`, `just build`) or the no-local-tagging rule so users searching on 'tag' or 'test before release' find the skill.

DimensionReasoningScore

Specificity

Names fully concrete actions — 'version bump + uv lock' — and concretely scopes the notes workflow ('harvested from PR release-note blocks and live in GitHub Releases'). It sits between anchor 3 (1-2 actions, not comprehensive) and anchor 5 (comprehensive action list) because only two explicit actions are named and prep-PR conventions (label, commit format) are omitted — noticeably above the midpoint but with minor coverage gaps.

4 / 5

Completeness

Explicitly answers both questions: what ('Prepare a release in mflux (version bump + uv lock; ...)') and when ('Use when preparing a release branch or release PR'). The when-clause is explicit but narrow — it largely restates the what rather than adding distinct trigger variations — so it fits anchor 4 ('when' could be more explicit or specific) rather than anchor 5's concrete, varied trigger phrases.

4 / 5

Trigger Term Quality

Includes natural phrases a user would say: 'prepare a release', 'release branch', 'release PR', 'version bump'. A few common variations are missing (e.g., 'cut a release', 'bump the version', 'release notes'), matching anchor 4's 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Prepare a release in mflux' plus the 'release branch or release PR' trigger carves out a clear niche with distinct triggers; no plausible conflict with other skills. Matches anchor 5 exactly, and the repo-scoped naming makes accidental triggering for another skill essentially impossible.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mflux-community/mflux

Path

.cursor/skills/mflux-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.