CtrlK
BlogDocsLog inGet started
Tessl Logo

create-release

Create releases with proper versioning, release notes, and Git tags

58

Quality

66%

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/create-release/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 thorough, executable release pipeline with strong validation and a clear step sequence, undermined mainly by redundant sections (Safety/Guardrails, Execution Contract/Steps, Output Format) that inflate the token budget without adding guidance.

Suggestions

Merge the 'Safety' and 'Guardrails' sections and drop the redundant 'Execution Contract' list since the 'Steps' section already covers the sequence.

Replace the static JSON record block with an actual here-doc/printf command so it is executable rather than a template illustration.

Remove or shorten the 'Output Format' section, which restates the release-notes template already generated in Step 4.

DimensionReasoningScore

Conciseness

The body is mostly executable bash with little concept over-explanation, but it carries clear redundancy — the 'Safety' and 'Guardrails' sections repeat the same checks, the 'Execution Contract' duplicates the 'Steps' list, and the 'Output Format' restates the release-notes template — so it could be tightened, fitting the 'mostly efficient but some unnecessary content' anchor.

3 / 5

Actionability

Guidance is concrete and largely copy-paste ready (uv run pytest, git tag -a, gh release create, etc.), with only minor gaps such as the static JSON record block showing literal $(...) expansions rather than runnable commands.

4 / 5

Workflow Clarity

The 9 numbered steps form a clear sequence with explicit validation checkpoints (tests, pre-commit, uncommitted-change check, branch check) plus a human confirmation gate before tagging, but error handling is 'exit 1' rather than fix-and-retry feedback loops, keeping it just below 5.

4 / 5

Progressive Disclosure

The single self-contained file is well organized into clearly labeled sections (Overview, Inputs, Safety, Steps, Artifacts, Example Usage) with no nested references, and the inlined templates are reasonable for a single workflow; minor organization gaps from redundancy keep it below 5.

4 / 5

Total

15

/

20

Passed

Description

66%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 states what the skill does with concrete, natural-vocabulary actions, but it omits any 'when to use' trigger guidance, which caps completeness and limits its usefulness for skill selection.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when creating a new release, publishing version notes, or tagging a release.'

Mention GitHub release publishing explicitly since it is a core step in the body.

Include common synonyms like 'changelog' or 'publish release' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Names the release domain and several concrete actions — 'proper versioning, release notes, and Git tags' — but stops short of comprehensive coverage (e.g., GitHub release publishing is not mentioned), fitting the 'several specific actions; minor gaps' anchor rather than the fully comprehensive 5.

4 / 5

Completeness

The 'what' is clear ('Create releases with proper versioning, release notes, and Git tags') but there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms 'releases', 'versioning', 'release notes', and 'Git tags' are terms users would actually say, giving good keyword coverage, though common synonyms like 'publish', 'changelog', or 'tag a release' are absent.

4 / 5

Distinctiveness Conflict Risk

Release creation is a fairly distinct niche with low conflict risk, though the absence of an explicit trigger context leaves minor overlap risk with general git/versioning skills, placing it just below the clearly-niched 5.

4 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
GetBindu/Bindu
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.