Agent skill

Claude Code Version Check

by ykdojo in ykdojo/claude-code-tips

Recommends whether to stay on the installed Claude Code version, update, or pin another one by comparing npm tags, release timing and the changelog.

Custom licenceAuto-check passedDevelopment

Install Claude Code Version Check

skills CLI
$ npx skills add ykdojo/claude-code-tips --skill version-check -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ykdojo/claude-code-tips version-check --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ykdojo/claude-code-tips.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/version-check .claude/skills/version-check && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
version-check
GitHub stars
10k
Token cost
~1.8k tokens
SKILL.md length
911 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Custom licence

At a glance

Recommends whether to stay on the installed Claude Code version, update, or pin another one by comparing npm tags, release timing and the changelog.

  • Works in 5 steps: What's installed vs what's published → Scan the changelog for regressions in… → Community sentiment (valuable - do this,… → …
  • Deciding whether to update Claude Code today or wait
  • SKILL.md covers Heuristics (read first), 1. What's installed vs what's…, 2. Scan the changelog for… and 3. Community sentiment…, plus 2 more sections
  • Calls claude, npm and python3; reaches raw.githubusercontent.com and reddit.com

What it does

Claude Code ships new builds very often, so the aim is a recommended range instead of one best version. The heuristics: the npm `stable` tag is not a long-term-support line and can trail an important fix, a quiet release is a good sign, posts comparing builds reveal which one to avoid, staying about a day behind the newest release is sensible, and a same-day build is acceptable when the tracker is quiet and it fixes something you are hitting.

The steps begin with `claude --version` and `npm view` for the published dist-tags and release times, then scan the changelog between the installed version and the latest for regressions that have not been fixed. The agent states plainly what is being traded when you take a newer build early, so you can decide with the risk in view.

When your agent uses it

  • Deciding whether to update Claude Code today or wait
  • Checking whether a recent release has known regressions
  • Seeing what changed between the installed version and the latest

Example prompts

  • “Tell me whether to update Claude Code now or wait, given what changed since my installed version.”
  • “Check if the latest Claude Code release has regressions people are reporting.”
  • “Recommend a Claude Code version to pin for this week.”

Requirements

  • npm and network access to the npm registry and the Claude Code changelog

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. What's installed vs what's published
  2. Scan the changelog for regressions in the gap
  3. Community sentiment (valuable - do this, don't skip it)
  4. Test the claim instead of arguing about it
  5. Recommend

What it can do on your machine

Read from SKILL.md and the folder at commit 577ac89. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • npm
    • python3
    • curl
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com
    • reddit.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Code Version Check loads about 1.8k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 911 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 911 words (~1,837 tokens).

“The goal is a recommendation: stay put, update, or pin to a specific version. Claude Code ships latest very frequently (often 1-2x/day), so "best version" is a moving target and the answer is usually a range, not a single build.”

— opening of SKILL.md by ykdojo, Custom licence
name
version-check

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/version-check of ykdojo/claude-code-tips.

Open the folder on GitHubat commit 577ac89

Compare with similar skills

Claude Code Version Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Code Version Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Code Version Check this skillykdojo/claude-code-tips10k—~1.8kAutomated safety check: PassCustom licence
Update Depsviclafouch/meme-studio110—~2.6kAutomated safety check: PassNone
Dependency Upgrade Protocoldralgorhythm/claude-agentic-framework124—~1.5kAutomated safety check: PassNone
Absolute Upgrademaddhruv/absolute2181 repos~1.1kAutomated safety check: PassMIT
Dependency Update BotVarnan-Tech/opendirectory672—~3kAutomated safety check: NotesMIT
Git Revert SafetyZaxbyHub/opencode-swarm488—~2.2kAutomated safety check: PassMIT

Similar skills

  • Update Deps

    viclafouch/meme-studio

    Audit all outdated dependencies with detailed research on changelogs, breaking changes, bug fixes, and deprecations.

    110 GitHub stars~2.6k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Dependency Upgrade Protocol

    dralgorhythm/claude-agentic-framework

    Sequences safe dependency upgrades: read the changelog, verify the version exists upstream, pin it, and keep major bumps in separate commits behind a full gate run.

    124 GitHub stars~1.5k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Absolute Upgrade

    maddhruv/absolute

    Dependency upgrades: outdated/vulnerable deps planned into semver waves (patch/minor batched, majors gated and changelog-read), applied incrementally with lockfiles regenerated and tests green after…

    218 GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Dependency Update Bot

    Varnan-Tech/opendirectory

    Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages.

    672 GitHub stars~3k tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes
  • Git Revert Safety

    ZaxbyHub/opencode-swarm

    Apply when reverting commits, undoing merges, or recovering from branch contamination.

    488 GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed

More from ykdojo/claude-code-tips

All 9 skills in this repo
  • Hacker News Summarizer

    ykdojo/claude-code-tips

    Fetches Hacker News top stories, a chosen story with its comment thread and the linked article through the official APIs, then summarizes them.

    10k GitHub stars~942 tokensUpdated 13 days ago
    Auto-check passed
  • Reddit JSON Fetcher

    ykdojo/claude-code-tips

    Fetches Reddit posts, threads and search results as JSON through a browser session, using a DuckDuckGo redirect to get past Reddit's automated-access block.

    10k GitHub stars~1.4k tokensUpdated 13 days ago
    Auto-check passed
  • Private GitHub Repo Search

    ykdojo/claude-code-tips

    Full-text searches across every one of the user's GitHub repos, including private ones, using a local mirror and ripgrep instead of GitHub's own search.

    10k GitHub stars~444 tokensUpdated 13 days ago
    Auto-check passed
  • CLAUDE.md Review

    ykdojo/claude-code-tips

    Mines your recent Claude Code conversations for rules that were broken, missing or stale, and suggests edits to global and project CLAUDE.md files.

    10k GitHub stars~677 tokensUpdated 13 days ago
    Auto-check passed
  • Conversation Half-Clone

    ykdojo/claude-code-tips

    Clones only the later half of the current Claude Code session into a fresh one, cutting token usage while keeping the recent work intact.

    10k GitHub stars~372 tokensUpdated 13 days ago
    Auto-check passed
  • Quarter Clone Conversation

    ykdojo/claude-code-tips

    Starts a new Claude Code session from only the last quarter of the current conversation, dropping earlier context to save tokens while keeping recent work.

    10k GitHub stars~401 tokensUpdated 13 days ago
    Auto-check passed

Works with

Categories

Questions about Claude Code Version Check

What does Claude Code Version Check do?

Recommends whether to stay on the installed Claude Code version, update, or pin another one by comparing npm tags, release timing and the changelog. Claude Code ships new builds very often, so the aim is a recommended range instead of one best version. The heuristics: the npm `stable` tag is not a long-term-support line and can trail an important fix, a quiet release is a good sign, posts comparing builds reveal which one to avoid, staying about a day behind the newest release is sensible, and a same-day build is acceptable when the tracker is quiet and it fixes something you are hitting.

When should I use Claude Code Version Check?

Claude Code Version Check fits situations like: deciding whether to update Claude Code today or wait; checking whether a recent release has known regressions; seeing what changed between the installed version and the latest.

How do I install Claude Code Version Check in Claude Code?

Run `npx skills add ykdojo/claude-code-tips --skill version-check -a claude-code`. Or copy the skill folder (skills/version-check in ykdojo/claude-code-tips) into .claude/skills/version-check in your project. Claude Code loads it when a task matches its description.

How do I install Claude Code Version Check in Codex?

Run `npx skills add ykdojo/claude-code-tips --skill version-check -a codex`. Or copy the skill folder (skills/version-check in ykdojo/claude-code-tips) into .agents/skills/version-check in your project. Codex loads it when a task matches its description.

Can I use Claude Code Version Check in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ykdojo/claude-code-tips --skill version-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/version-check, .gemini/skills/version-check, .github/skills/version-check and .opencode/skills/version-check in your project.

What does Claude Code Version Check need to run?

Going by SKILL.md and its folder, Claude Code Version Check needs the command-line tools its instructions call (claude, npm, python3, curl and gh). Our summary lists: npm and network access to the npm registry and the Claude Code changelog.

Does Claude Code Version Check access the network?

SKILL.md names 2 domains. In commands or code: raw.githubusercontent.com and reddit.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Claude Code Version Check safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Claude Code Version Check use?

Claude Code Version Check has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Claude Code Version Check use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude Code Version Check?

Skills that share tags, products or a category with Claude Code Version Check: Update Deps (viclafouch/meme-studio, 110 stars), Dependency Upgrade Protocol (dralgorhythm/claude-agentic-framework, 124 stars), Absolute Upgrade (maddhruv/absolute, 218 stars) and Dependency Update Bot (Varnan-Tech/opendirectory, 672 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Code Version Check?

ykdojo (a GitHub user) maintains it in ykdojo/claude-code-tips, which has 10,200 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 25, 2026.

Source: ykdojo/claude-code-tips on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.