update-guides

Sync AI guides from the ai-dev framework to a target project.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/aifuun/u-safe-archive --skill update-guides
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-guides
Source: https://github.com/aifuun/u-safe-archive/tree/main/.claude/skills/update-guides
Command: npx skills add https://github.com/aifuun/u-safe-archive --skill update-guides

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Sync AI development guides from the ai-dev framework to a target project, ensuring consistent documentation and version tracking.

Core Features & Use Cases

  • Sync AI guides from .claude/guides/ in ai-dev to a target project, replacing outdated guides to keep documentation up-to-date.
  • Create a version marker (.ai-guides-version) to enable traceability of framework upgrades and guide deployments.
  • Supports dry-run previews to show exactly what would be changed without touching files.

Quick Start

Run the update-guides script from the ai-dev directory with the path to the target project.

Frequently Asked Questions about update-guides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync AI guides across multiple projects using rsync?

To sync AI guides across projects, use the update-guides script from the ai-dev framework. It replaces the .claude/guides directory in your target project with the latest framework guides and generates a .ai-guides-version file to track the deployment.

Can I preview guide synchronization changes before modifying files?

Yes, you can preview guide synchronization changes using the dry-run preview mode. This feature shows exactly which .claude/guides files would be replaced or deleted in the target project without actually touching any files.

How does version tracking work for AI development guides?

Version tracking for AI development guides works by generating a .ai-guides-version file in the target project. This marker records the framework commit and timestamp, ensuring full traceability of framework upgrades and guide deployments.

What happens to outdated guides when syncing from the ai-dev framework?

When syncing guides from the ai-dev framework, the script deletes any existing outdated guides in the target project's .claude/guides directory before copying all new guide files from the framework source.

Does the guide synchronization script validate target project paths?

Yes, the guide synchronization script validates input paths before executing. It checks the target project path to ensure the rsync operation can safely replace the .claude/guides directory and write the version marker.