SKILL·EAD85C

version-check

ykdojo
Updated 9 days ago
9,015
692
9,015
View on GitHub
Developmentai

About

This skill provides recommendations on which Claude Code version to run and whether to update, based on recent release patterns and community feedback. It analyzes version stability, bug reports, and change logs to advise staying on a current version, updating, or pinning to a specific build. Use it when developers ask about the best/safe version, update timing, or recent release issues.

Quick Install

Claude Code

Recommended
Primary
npx skills add ykdojo/claude-code-tips -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/ykdojo/claude-code-tips
Git CloneAlternative
git clone https://github.com/ykdojo/claude-code-tips.git ~/.claude/skills/version-check

Copy and paste this command in Claude Code to install this skill

Documentation

Claude Code version check

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.

Heuristics (read first)

  • stable lags latest and is NOT an LTS. The npm stable dist-tag is just a pointer that trails latest by a handful of patch releases. It can even sit behind an important fix release, so "stable" does not mean "most bugs fixed." Don't blindly recommend @stable.
  • Quiet version = good sign. If nobody is complaining about a recent release, that's a positive signal. A loud pile-on about a specific build is the thing to avoid.
  • Version comparisons are the strongest signal. Posts where people compare builds ("X broke Y, rolled back to Z") tell you exactly which release to avoid.
  • Stay ~a day behind the bleeding edge. Avoid a release that's only a few hours old - let others surface same-day regressions first.
  • The real lever is when you update, not stable-vs-latest. Default Claude Code auto-updates to latest constantly, which is how you drift onto a same-day regression.

1. What's installed vs what's published

claude --version
npm view @anthropic-ai/claude-code dist-tags --json

dist-tags shows latest, stable, and next. Compare against the installed version to see how far ahead/behind each pointer is.

Recent releases and their timestamps (to see how fast things are shipping):

npm view @anthropic-ai/claude-code time --json | python3 -c "import sys,json;d=json.load(sys.stdin);print('\n'.join(f'{k}: {v}' for k,v in list(d.items())[-8:]))"

2. Scan the changelog for regressions in the gap

Fetch the changelog and read the entries between the installed version and latest. Look for "Fixed ... regression in X" lines - if a recent build introduced a regression that has not yet been fixed, that's the one to avoid.

curl -sL https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md | awk '/## <LATEST>/,/## <INSTALLED>/'

(Substitute the two version numbers.) A release that is mostly "Fixed …" after a noisy one is usually a safe landing spot.

3. Community sentiment (optional but valuable)

Check r/ClaudeAI for recent posts about version stability and comparisons. Reddit returns HTTP 403 to curl (including from datacenter IPs), so use Playwright - navigate to the search .json URL and JSON.parse(document.body.innerText). See the reddit-fetch skill for the full pattern.

https://www.reddit.com/r/ClaudeAI/search.json?q=claude+code+update+broke+OR+regression&restrict_sr=on&sort=top&t=month&limit=25

Apply the heuristics above: a positive or quiet recent-update thread is reassuring; a high-score "X is broken" thread names the build to skip.

4. Recommend

  • If the installed version is in the recent, well-received range and nothing in the gap regressed: stay put, don't chase a release that's only hours old.
  • If there's a known regression in a build, recommend the last good version and npm install -g @anthropic-ai/[email protected] to pin/rollback.
  • For anyone who's been burned: disable the auto-updater and update deliberately (the repo's setup script does this), rather than religiously tracking @stable.

GitHub Repository

ykdojo/claude-code-tips
Path: skills/version-check
0
agenticagentic-aiagentic-codingagentic-workflowaiclaude
FAQ

Frequently asked questions

What is the version-check skill?

version-check is a Claude Skill by ykdojo. Skills package instructions and resources that Claude loads on demand, so Claude can perform version-check-related tasks without extra prompting.

How do I install version-check?

Use the install commands on this page: add version-check to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does version-check belong to?

version-check is in the Development category, tagged ai.

Is version-check free to use?

Yes. version-check is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.

Related Skills

qmd
Development

qmd is a local search and indexing CLI tool that enables developers to index and search through local files using hybrid search combining BM25, vector embeddings, and reranking. It supports both command-line usage and MCP (Model Context Protocol) mode for integration with Claude. The tool uses Ollama for embeddings and stores indexes locally, making it ideal for searching documentation or codebases directly from the terminal.

View skill
subagent-driven-development
Development

This skill executes implementation plans by dispatching a fresh subagent for each independent task, with code review between tasks. It enables fast iteration while maintaining quality gates through this review process. Use it when working on mostly independent tasks within the same session to ensure continuous progress with built-in quality checks.

View skill
mcporter
Development

The mcporter skill enables developers to manage and call Model Context Protocol (MCP) servers directly from Claude. It provides commands to list available servers, call their tools with arguments, and handle authentication and daemon lifecycle. Use this skill for integrating and testing MCP server functionality in your development workflow.

View skill
adk-deployment-specialist
Development

This skill deploys and orchestrates Vertex AI ADK agents using A2A protocol, managing AgentCard discovery, task submission, and supporting tools like Code Execution Sandbox and Memory Bank. It enables building multi-agent systems with sequential, parallel, or loop orchestration patterns in Python, Java, or Go. Use it when asked to deploy ADK agents or orchestrate agent workflows on Google Cloud.

View skill