CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

version-check

Recommend which Claude Code version to run, or whether to update. Use when asked which Claude Code version is best/safe, whether to update now, whether a recent release is buggy, or what changed since the installed version.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 exceptionally actionable, token-efficient skill body: executable commands with signposted placeholders, explicit verification steps, and dense non-obvious domain knowledge. The only structural gap is that everything lives inline in one file with a couple of dangling un-pathed references, keeping it just short of the top progressive-disclosure anchor.

DimensionReasoningScore

Conciseness

The body is lean and contains essentially no explanation of concepts Claude already knows; every section conveys non-obvious domain knowledge (stable is not an LTS, Reddit blocking routes and the DuckDuckGo hop, modelUsage as the honest answer). No specific dates or version numbers are inlined. Matches anchor 5; it is not merely 'efficient with minor trims' as in anchor 4.

5 / 5

Actionability

Commands are copy-paste ready throughout (claude --version, npm view dist-tags/time, curl+awk changelog slice, gh api with full jq projection, the claude -p modelUsage probe, native-vs-npm install detection), and every placeholder is explicitly signposted ("Substitute the two version numbers", "Set <DATE> to ~3 days before today"). Matches anchor 5 with common cases covered.

5 / 5

Workflow Clarity

A clear numbered 1-5 sequence (installed vs published, changelog gap, sentiment, empirical test, recommendation) with explicit validation ("confirm with claude --version afterwards", "Re-run the same command after updating to confirm the number moved") and error-recovery guidance (EEXIST handling, do not --force). Matches anchor 5; no destructive/batch validation cap applies to this advisory skill.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers and a read-first heuristics block, but the skill is ~105 lines in a single file with no reference split, and pointers like "the repo's setup script" and the external reddit-fetch skill carry no path or link. This fits anchor 4 (good structure, minor organization gaps) rather than anchor 5, which expects well-signaled one-level-deep references; the under-50-line simple-skill exception does not apply.

4 / 5

Total

19

/

20

Passed

Description

82%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 with an explicit, well-phrased trigger clause and a clear niche. The only relative weakness is that the 'what' stays at the decision level without naming the underlying concrete actions (changelog scanning, community sentiment, pinning/rollback).

DimensionReasoningScore

Specificity

The description names the domain and the core decision actions ("Recommend which Claude Code version to run, or whether to update") but does not enumerate several specific actions covering the skill's capability range. It fits anchor 3 (domain plus 1-2 concrete actions) rather than anchor 4, which expects several listed actions.

3 / 5

Completeness

It explicitly answers both what ("Recommend which Claude Code version to run, or whether to update") and when, with a "Use when asked..." clause listing four concrete trigger phrases. This matches anchor 5 exactly and is clearly above anchor 4, whose 'when' is less specific.

5 / 5

Trigger Term Quality

The "Use when asked which Claude Code version is best/safe, whether to update now, whether a recent release is buggy, or what changed since the installed version" clause covers multiple natural user phrasings, but misses common variants such as "should I update" as a standalone, "is it safe to update", or "downgrade/rollback". This lands between anchors 4 and 5, noticeably above the midpoint, so 4.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Claude Code version selection/update decisions) with distinct, specific triggers that no adjacent skill would claim. Minimal conflict risk, matching anchor 5.

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

ykdojo/claude-code-tips

Path

skills/version-check/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.