skill-sync

name	skill-sync
description	Use when the user asks to "sync skills", "set up skill-sync", "check skill status", "validate skills", "preview skill changes", "diagnose skills", "pin a skill", "unpin a skill", "prune skills", or "promote skill changes".
version	0.2.0
tools	Bash, Read, Write, Edit

Skill Sync

Read skill-sync.yaml (or .claude/skills/skill-sync.yaml) first. It defines sources, destination, excludes, pins, and validation. Route to the operation guide below and read the file in the Read column before acting.

Actions

Action	Read
setup	references/operations.md
sync	references/operations.md
status	references/operations.md
validate	references/operations.md
diff	references/operations.md
doctor	references/operations.md
pin	references/operations.md
unpin	references/operations.md
prune	references/operations.md
promote	references/operations.md
help	this table

Rules

• Stop before sync if managed tracked files are dirty. Review and commit produced tracked changes before unrelated work.
• Never edit generated/materialized copies as the source of truth unless the config says they are authoritative.
• Global flags: --dry-run, --force, --source NAME, --dest PATH, --verbose. Use --force only when source/destination ownership is known.