adaptationio/auto-claude-updater

Auto-Claude Updater

Automatic synchronization of skills and documentation with upstream Auto-Claude releases.

Overview

This skill provides:

• Version checking - Detect new Auto-Claude releases
• Skill synchronization - Update local skills with latest docs
• Changelog parsing - Extract relevant changes
• Compatibility checks - Ensure skill-version alignment

Quick Commands

Check for Updates

# Check if new version available
auto-claude-update --check

# Or using git
cd /path/to/Auto-Claude
git fetch origin
git log main..origin/main --oneline

Update Auto-Claude

# Update from source
cd /path/to/Auto-Claude
git pull origin main
npm run install:all

# Or download new release
# https://github.com/AndyMik90/Auto-Claude/releases/latest

Sync Skills

# Run skill update script
cd /path/to/skills-repo
./scripts/sync-auto-claude-skills.sh

Update Workflow

1. Check Version

# Current version
cat /path/to/Auto-Claude/package.json | grep '"version"'

# Latest release
curl -s https://api.github.com/repos/AndyMik90/Auto-Claude/releases/latest | grep '"tag_name"'

2. Review Changelog

# View recent changes
cat /path/to/Auto-Claude/CHANGELOG.md | head -100

# Or fetch from GitHub
curl -s https://raw.githubusercontent.com/AndyMik90/Auto-Claude/main/CHANGELOG.md | head -100

3. Update Repository

cd /path/to/Auto-Claude

# Stash local changes
git stash

# Pull latest
git pull origin main

# Reinstall dependencies
npm run install:all

# Restore local changes
git stash pop

4. Sync Skills

After updating, synchronize skill documentation:

# Copy latest docs to skills
./scripts/sync-auto-claude-skills.sh

# Or manually update
cp /path/to/Auto-Claude/README.md /path/to/skills/auto-claude-setup/references/
cp /path/to/Auto-Claude/CLAUDE.md /path/to/skills/auto-claude-cli/references/
cp /path/to/Auto-Claude/guides/CLI-USAGE.md /path/to/skills/auto-claude-cli/references/

Automatic Update Script

sync-auto-claude-skills.sh

#!/bin/bash
# Auto-Claude Skills Sync Script

AUTO_CLAUDE_PATH="${AUTO_CLAUDE_PATH:-/mnt/c/data/github/external/Auto-Claude}"
SKILLS_PATH="${SKILLS_PATH:-.claude/skills}"

echo "Syncing Auto-Claude skills..."

# Check current version
CURRENT_VERSION=$(cat "$AUTO_CLAUDE_PATH/package.json" | grep '"version"' | sed 's/.*"version": "\(.*\)".*/\1/')
echo "Auto-Claude version: $CURRENT_VERSION"

# Update setup skill references
echo "Updating auto-claude-setup..."
cp "$AUTO_CLAUDE_PATH/README.md" "$SKILLS_PATH/auto-claude-setup/references/"
cp "$AUTO_CLAUDE_PATH/CONTRIBUTING.md" "$SKILLS_PATH/auto-claude-setup/references/"

# Update CLI skill references
echo "Updating auto-claude-cli..."
cp "$AUTO_CLAUDE_PATH/CLAUDE.md" "$SKILLS_PATH/auto-claude-cli/references/"
cp "$AUTO_CLAUDE_PATH/guides/CLI-USAGE.md" "$SKILLS_PATH/auto-claude-cli/references/" 2>/dev/null || true

# Update memory skill references
echo "Updating auto-claude-memory..."
cp "$AUTO_CLAUDE_PATH/apps/backend/.env.example" "$SKILLS_PATH/auto-claude-memory/references/"

# Update version in all skills
echo "Updating version references..."
for skill_dir in "$SKILLS_PATH"/auto-claude-*; do
    if [ -f "$skill_dir/SKILL.md" ]; then
        sed -i "s/auto-claude-version: 2.7.2
    fi
done

echo "Sync complete!"

Save to .claude/skills/auto-claude-updater/scripts/sync-auto-claude-skills.sh and make executable:

chmod +x .claude/skills/auto-claude-updater/scripts/sync-auto-claude-skills.sh

Update Detection

Check for Breaking Changes

# Compare versions
CURRENT="2.7.0"
LATEST=$(curl -s https://api.github.com/repos/AndyMik90/Auto-Claude/releases/latest | jq -r '.tag_name' | sed 's/v//')

# Major version change = breaking
if [[ "${CURRENT%%.*}" != "${LATEST%%.*}" ]]; then
    echo "BREAKING: Major version change detected!"
fi

Monitor GitHub Releases

# Watch for new releases
gh release list -R AndyMik90/Auto-Claude --limit 5

# Get release notes
gh release view v2.7.2 -R AndyMik90/Auto-Claude

Version Compatibility

Skill Version Matrix

| Skill Version | Auto-Claude Version | Status | |---------------|---------------------|--------| | 1.0.0 | 2.7.x | Current | | 1.0.0 | 2.6.x | Compatible | | 1.0.0 | 2.5.x | Limited | | 1.0.0 | 2.4.x | Not tested |

Breaking Changes Log

Track breaking changes that affect skills:

## Breaking Changes

### v2.7.0
- Memory system switched to LadybugDB (no Docker)
- New Ollama embedding support

### v2.6.0
- New spec pipeline phases
- Changed implementation_plan.json format

### v2.5.0
- Claude Agent SDK required
- Removed direct Anthropic API support

Automation

GitHub Actions Workflow

# .github/workflows/sync-auto-claude.yml
name: Sync Auto-Claude Skills

on:
  schedule:
    - cron: '0 0 * * *'  # Daily at midnight
  workflow_dispatch:

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Check for updates
        id: check
        run: |
          LATEST=$(curl -s https://api.github.com/repos/AndyMik90/Auto-Claude/releases/latest | jq -r '.tag_name')
          echo "latest=$LATEST" >> $GITHUB_OUTPUT

      - name: Clone Auto-Claude
        run: |
          git clone --depth 1 https://github.com/AndyMik90/Auto-Claude.git /tmp/Auto-Claude

      - name: Sync skills
        run: |
          AUTO_CLAUDE_PATH=/tmp/Auto-Claude ./scripts/sync-auto-claude-skills.sh

      - name: Create PR
        uses: peter-evans/create-pull-request@v5
        with:
          title: "chore: sync Auto-Claude skills to ${{ steps.check.outputs.latest }}"
          body: "Automated skill sync with upstream Auto-Claude"
          branch: auto-claude-sync

Pre-commit Hook

# .husky/pre-commit
#!/bin/sh

# Check Auto-Claude version
CURRENT=$(grep 'auto-claude-version:' .claude/skills/auto-claude-setup/SKILL.md | sed 's/.*: //')
LATEST=$(curl -s https://api.github.com/repos/AndyMik90/Auto-Claude/releases/latest | jq -r '.tag_name' | sed 's/v//')

if [ "$CURRENT" != "$LATEST" ]; then
    echo "Warning: Auto-Claude skills may be outdated"
    echo "  Current: $CURRENT"
    echo "  Latest:  $LATEST"
    echo "Run: ./scripts/sync-auto-claude-skills.sh"
fi

Manual Updates

Update Specific Skill

# Update just the CLI skill
cd /path/to/skills/auto-claude-cli

# Get latest CLAUDE.md
curl -o references/CLAUDE.md https://raw.githubusercontent.com/AndyMik90/Auto-Claude/main/CLAUDE.md

# Update version
sed -i 's/auto-claude-version: 2.7.2

Add New Feature Documentation

When Auto-Claude adds new features:

1. Read the changelog
2. Update relevant SKILL.md
3. Add new examples
4. Update references

Troubleshooting

Sync Fails

# Check paths
echo $AUTO_CLAUDE_PATH
ls -la $AUTO_CLAUDE_PATH

# Check permissions
ls -la .claude/skills/

Version Mismatch

# Force version update
VERSION="2.7.2"
for skill in .claude/skills/auto-claude-*; do
    sed -i "s/auto-claude-version: 2.7.2
done

Missing References

# Ensure reference directories exist
for skill in .claude/skills/auto-claude-*; do
    mkdir -p "$skill/references"
done

Related Skills

• auto-claude-setup: Installation guide
• auto-claude-cli: CLI reference
• auto-claude-troubleshooting: Debugging