Claude Skill Version Sync — Development skill for Claude Code

Version Sync

A Claude Code skill for detecting and synchronizing Node.js version specifications across project files.

Installation

As a Claude Code Skill

# Clone to your Claude skills directory
git clone https://github.com/wrsmith108/claude-skill-version-sync.git ~/.claude/skills/version-sync

Standalone Usage

npx tsx scripts/index.ts  [options]

Trigger Phrases

This skill activates when you mention:

• "version mismatch"
• "upgrade node"
• "sync versions"
• "update node version"
• "version drift"
• "check node versions"
• "node version conflict"

Commands

Check Version Status

npx tsx scripts/index.ts check

Scans the current project for Node.js version specifications and reports any mismatches.

Update All Versions

npx tsx scripts/index.ts update 

Updates all version files to the specified target version.

**Options:**

• --dry-run - Preview changes without modifying files
• --no-backup - Skip creating backup files before updates

Supported Files

File	Pattern	Example
.nvmrc	First line number	22
package.json	engines.node	">=22.0.0"
Dockerfile	FROM node:	FROM node:22-slim
.github/workflows/*.yml	node-version	node-version: '22'
docker-compose.yml	image: node:	image: node:22-alpine

Usage Examples

# Check for version mismatches
npx tsx scripts/index.ts check

# Preview updating to Node 22
npx tsx scripts/index.ts update 22 --dry-run

# Update all files to Node 22
npx tsx scripts/index.ts update 22

Output Format

## Node.js Version Status

| File | Current | Target | Action |
|------|---------|--------|--------|
| .nvmrc | 22 | 22 | No change |
| Dockerfile | 20-slim | 22-slim | Will update |
| package.json | >=20.0.0 | >=22.0.0 | Will update |

Best Practices

1. Always run check first to understand c