CtrlK
BlogDocsLog inGet started
Tessl Logo

release

Prepare a lading release. Updates CHANGELOG.md, bumps version in Cargo.toml, updates Cargo.lock, commits, and creates a PR.

80

Quality

76%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/release/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 does a good job listing specific concrete actions for the release process and is clearly scoped to the 'lading' project, making it distinctive. However, it lacks an explicit 'Use when...' clause and could benefit from additional trigger terms that users might naturally say when requesting a release.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when preparing a new lading release, cutting a version, or bumping the lading version number.'

Include additional natural trigger terms like 'version bump', 'cut a release', 'new version', or 'publish lading' to improve discoverability.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: updates CHANGELOG.md, bumps version in Cargo.toml, updates Cargo.lock, commits, and creates a PR. These are all clearly defined steps.

3 / 3

Completeness

Clearly answers 'what does this do' with the list of actions, but lacks an explicit 'Use when...' clause. The 'when' is only implied by the opening phrase 'Prepare a lading release'.

2 / 3

Trigger Term Quality

Includes some relevant terms like 'release', 'CHANGELOG', 'Cargo.toml', 'version', and 'PR', but is narrowly scoped to 'lading' (a specific project name). Missing common variations like 'version bump', 'cut a release', 'new version', or 'publish'.

2 / 3

Distinctiveness Conflict Risk

The description is highly specific to the 'lading' project and its particular release workflow (Cargo.toml, CHANGELOG.md, Cargo.lock). This is unlikely to conflict with other skills due to the project-specific naming.

3 / 3

Total

10

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured release process skill that is concise, clearly sequenced, and appropriately scoped. Its main weakness is the CHANGELOG.md manipulation step, which could benefit from a concrete before/after example to eliminate ambiguity about the expected format. The safety constraint about tag pushing and the user confirmation checkpoint are good practices.

Suggestions

Add a concrete before/after example for the CHANGELOG.md transformation in step 3 to eliminate ambiguity about the expected format (e.g., show the markdown structure before and after the edit).

DimensionReasoningScore

Conciseness

Every line serves a purpose. No unnecessary explanations of what a changelog is, what semver means, or how git works. The skill assumes Claude's competence and provides only the project-specific details needed.

3 / 3

Actionability

The steps are concrete and specific (exact file paths, commit message format, specific commands), but some steps like editing CHANGELOG.md lack a concrete example of the expected format. The changelog manipulation instructions describe what to do rather than showing an exact before/after example, which could lead to ambiguity.

2 / 3

Workflow Clarity

The 7-step process is clearly sequenced with logical ordering. It includes a confirmation checkpoint (step 1: confirm version with user), a validation step (step 5: cargo check to propagate changes), and explicit safety constraints (never use git push --tags). The workflow covers the full lifecycle including post-merge tagging.

3 / 3

Progressive Disclosure

For a single-purpose skill under 50 lines with no need for external references, the content is well-organized into clearly labeled sequential sections. Each section is focused and appropriately sized.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
DataDog/lading
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.