Prepare a lading release. Updates CHANGELOG.md, bumps version in Cargo.toml, updates Cargo.lock, commits, and creates a PR.
64
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/release/SKILL.mdQuality
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 the trigger terms could be broader to capture natural user language like 'cut a release' or 'version bump'.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user asks to prepare a release, cut a new version, or bump the version for lading.'
Include additional natural trigger terms such as 'version bump', 'cut a release', 'new version', or 'publish release' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
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' (updates changelog, bumps version, updates lock file, commits, creates PR), but lacks an explicit 'Use when...' clause specifying when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2. | 2 / 3 |
Trigger Term Quality | Includes some relevant terms like 'release', 'CHANGELOG', 'Cargo.toml', 'version', and 'PR', but the term 'lading' is very specific/niche and users might say 'version bump', 'cut a release', 'new release', or 'publish' which are not covered. | 2 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to the 'lading' project's release process, mentioning specific files (Cargo.toml, Cargo.lock, CHANGELOG.md) and a specific workflow. This is unlikely to conflict with other skills. | 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 that the CHANGELOG manipulation (step 3) could be more concrete with a before/after example, and the Cargo.toml edit could show the exact line to modify. Overall it's a strong skill that respects Claude's intelligence while providing project-specific guidance.
Suggestions
Add a brief before/after example for the CHANGELOG.md restructuring in step 3 to eliminate ambiguity about the expected format
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every step is lean and purposeful. No unnecessary explanations of what a changelog is, what semver means, or how git works. The skill assumes Claude's competence and only provides project-specific instructions. | 3 / 3 |
Actionability | Steps are concrete with specific file paths and git commands, but some steps like 'Edit lading/Cargo.toml' and the CHANGELOG manipulation are described rather than shown with exact code or sed commands. The CHANGELOG restructuring in step 3 could benefit from a before/after example to avoid ambiguity. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with 7 numbered steps in logical order. 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 post-merge reminder in step 7 is a good feedback mechanism. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single well-defined task, the content is appropriately structured with clear numbered sections. No bundle files are needed, and no unnecessary external references are created. The organization is clean and easy to navigate. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
e98e305
Table of Contents
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.