auto-claude-updater
SKILL.md
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:
- Read the changelog
- Update relevant SKILL.md
- Add new examples
- 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
Weekly Installs
3
Repository
adaptationio/skrillzInstalled on
claude-code3
opencode2
kilo1
windsurf1
zencoder1
cline1