CtrlK
BlogDocsLog inGet started
Tessl Logo

release

Bump the Plano version across all required files. Use when preparing a release.

64

Quality

76%

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

Quality

Content

80%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 tight, highly actionable script for a version bump that makes excellent use of tokens, with a complete target-file list, sensible exclusions, and a lockfile refresh step. The main gap is the absence of a post-edit validation step for what is a batch operation, and the version-string formats per file are left for the model to discover.

Suggestions

Add a verification step after the edits, e.g., "Run `grep -rn '<old-version>' . --exclude-dir=.git` and confirm zero matches (excluding lock files) before running `uv lock`" — this closes the feedback loop for an 11-file batch change.

Show the expected version-string form for at least the non-obvious files (e.g., `__version__ = "0.4.11"` in `cli/planoai/__init__.py`, `APP_VERSION = "0.4.11"` in `consts.py`, the badge/URL in `Hero.tsx`) so replacements are deterministic instead of discovered per file.

Clarify bump-type semantics, e.g., what `major`, `minor`, and `patch` map to when read from `cli/planoai/__init__.py`, since the argument parsing is currently described only by example.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no explanation of what versioning is, no library comparisons, no padding — every line is an instruction, an exclusion, or a file path. Matches the "every token earns its place" anchor.

5 / 5

Actionability

Concrete guidance throughout: an exact 11-file list, an explicit example ("0.4.11 → 0.4.12"), a runnable command ("cd cli && uv lock"), and explicit exclusions ("Do NOT change version strings in *.lock files or Cargo.lock"). Not 5 because the core edit operation is left implicit — the expected version-string format per file (e.g., `__version__ = "0.4.11"` in `__init__.py` vs. `version: 0.4.11` in CI YAML) is never shown, so each replacement requires discovery.

4 / 5

Workflow Clarity

The sequence is clear (resolve version, with user confirmation when auto-incrementing → update all files → run `uv lock` → show summary), but this is a batch operation across 11 files with no validation step to catch missed or malformed replacements (e.g., grep for the old version afterwards). Per the rubric guideline, a batch workflow without validation/verification is capped at 3.

3 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references; the body is organized into clearly separated concerns (argument handling, file list, exclusions, lockfile update, summary) with no monolithic wall of text and no buried references. Per the rubric's simple-skill guideline, this qualifies for 5.

5 / 5

Total

17

/

20

Passed

Description

73%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 concise, third-person description that clearly states what the skill does and when to use it, with an explicit 'Use when' trigger clause. Its main weakness is thin trigger-term coverage and a single-action framing of what is actually a multi-file update workflow.

Suggestions

Broaden the trigger clause to include synonyms users naturally say, e.g., "Use when preparing a release, publishing a new version, or bumping the Plano version."

Name one or two more concrete actions in the description (e.g., "updates version strings across config, docs, and workflow files, then refreshes the lockfile") to raise specificity.

Consider mentioning the version-bump types (major/minor/patch) in the description so users know they can request a specific bump.

DimensionReasoningScore

Specificity

"Bump the Plano version across all required files" names the domain (Plano versioning) and one concrete action (bump version), but stops short of listing the fuller set of concrete actions (update files, refresh lockfile). Not 4 because only a single action is named rather than several specific actions; not 2 because the action is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (bump the Plano version across all required files) and the 'when' is explicit ("Use when preparing a release"), so it avoids the 3 cap for a missing trigger clause. Not 5 because the 'when' is a single brief condition and could name more concrete trigger situations (e.g., publishing, cutting a version).

4 / 5

Trigger Term Quality

"version", "bump", "release", "preparing a release" are natural phrases a user would say when needing this skill. Not 5 because common synonyms like "publish", "cut a release", or "new version" are absent; not 3 because the included terms are natural user phrasings, not jargon.

4 / 5

Distinctiveness Conflict Risk

"Plano" scopes the skill to a specific named project, making it clearly distinguishable from generic versioning or release skills; minimal conflict risk. Confirmed not below 5, as the anchor example of a clear niche with distinct triggers is the closest match.

5 / 5

Total

16

/

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
katanemo/plano
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.