sync

Syncs WDS skill files from a project installation to global Claude Code command directories.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill sync-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/sync
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill sync-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? WDS skills installed inside a single project (_bmad/wds/) are not available in other projects or Claude Code sessions. This Skill copies the agent activation commands, tools, and data files into the user's home directory (~/.claude/commands/ and ~/.claude/wds/) so the /saga, /freya, /mimir, /start, /wrap, and /handoff commands work globally, and it keeps them up to date automatically on every agent activation. ## Core Features & Use Cases - Automatic silent sync on activation: Agents call it on every activation; it diffs the installed wrap.md against the global copy and syncs only when files differ, never blocking activation on failure. - First-time consent flow: When no global commands exist yet, it asks the user once before syncing, and respects a negative answer for the rest of the session. - Cross-platform file operations: Provides both bash (macOS/Linux) and PowerShell (Windows) commands for directory creation, file comparison, and copying, skipping missing source files without errors. - Use Case: A developer installs WDS via npx bmad-method in one project, then opens a different project and wants /saga and /wrap available immediately without reinstalling. ## Quick Start Ask the agent to sync WDS skills globally by saying "sync skills" or "update WDS".

Frequently Asked Questions about sync

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

FAQPage Schema
How do I make Claude Code skills available in all projects?

Run the sync skill to copy WDS skill files from the project's _bmad/wds/ directory into ~/.claude/commands/. After syncing, commands like /saga, /freya, /mimir, /start, /wrap, and /handoff work in every Claude Code session.

How do I update WDS skills after installing a new version?

Say "sync", "update WDS", or "check for updates" to trigger a verbose sync. The skill compares the global wrap.md against the project copy and overwrites changed files, reporting each step.

Does the sync skill work on Windows?

Yes. The skill includes PowerShell equivalents for every operation, using $env:USERPROFILE for the home directory, New-Item for directory creation, and Compare-Object for file comparison.

What happens if WDS is not installed in the current project?

In silent mode the sync stops without any output. In verbose mode it reports that WDS is not installed and suggests running npx bmad-method install.

Why does the sync skill not run automatically on activation?

It does run on every agent activation, but silently. It only asks for confirmation the first time when no global commands exist; afterwards it syncs changed files without prompting and never blocks activation if it fails.