skill-snapshot-skill

Skill Snapshot provides version control for Claude Code skills, allowing you to save snapshots, restore previous versions, and compare changes with ease. Backups are automatically stored in a private GitHub repository, ensuring your skill modifications are secure and recoverable. The skill includes smart scanning to identify which skills need backup, automatic version tagging, and skip rules that prevent backing up archived skills, symlinks, or skills with existing version control. Operations teams can initialize repositories, save snapshots before modifications, restore broken skills to known-good versions, and track changes across multiple skill versions.

[{"step":"Prepare your skill details","action":"Gather the current skill name, description, and any recent changes made. Ensure you have access to the private GitHub repository where snapshots will be stored.","tip":"Use your organization's naming convention for skills (e.g., 'customer-support-ticket-classifier'). Include version numbers in your descriptions for clarity."},{"step":"Generate the snapshot","action":"Run the prompt template in your AI assistant, replacing [PLACEHOLDERS] with actual values. For example: 'Create a version control snapshot for the AI skill 'Customer Support Ticket Classifier' with the following details: 'AI skill that automatically classifies incoming support tickets...'. Save the snapshot to the private GitHub repository 'acme-ai-skills' under the branch 'main'. Include a changelog entry summarizing the changes made since the last version v1.2.2.'","tip":"Use the `--dry-run` flag if your AI assistant supports it to preview the snapshot before committing. This helps catch errors early."},{"step":"Review and commit","action":"Review the generated snapshot JSON for accuracy. Commit the changes to GitHub using a descriptive commit message like 'feat: update Customer Support Ticket Classifier to v1.2.3'.","tip":"Use GitHub's pull request workflow to ensure the snapshot is reviewed by another team member before merging to the main branch."},{"step":"Restore or compare versions","action":"To restore a previous version, use the GitHub repository to checkout the desired snapshot branch or tag. To compare versions, use GitHub's diff tools or the AI assistant to analyze changes between two snapshots.","tip":"For large teams, create a Slack or Teams notification when a new snapshot is committed to keep everyone informed of skill updates."}]