Skill sync

Skill onfire7777/universal-ai-skills-library/skills/skill-sync

Sync and install skills from a GitHub skills repository into a local or global AI skill root. Use when the user asks to install skills, update skills, sync skills from GitHub, load a skill library, or ensure cross-AI skill roots are up to date.From its SKILL.md

Install

npx -y skills add onfire7777/universal-ai-skills-library --skill skill-sync

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, 647 tokens by cl100k_base, as published. Nobody here has run it

Skill Sync

Sync all skills from a GitHub repository into /home/ubuntu/skills/ with version tracking, validation, and change detection.

Quick Start

Run the sync script:

python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py

Default repo: onfire7777/universal-ai-skills-library. The script handles everything automatically.

Commands

# Full sync (clone/pull + install/update all skills)
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py

# Sync from a different repo
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py --repo user/repo-name

# Preview changes without installing
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py --dry-run

# Only sync skills matching keywords
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py --filter "security,audit"

# Force overwrite locally modified skills
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py --force

# Validate all currently installed skills
python3 /home/ubuntu/skills/skill-sync/scripts/sync_skills.py --validate-only

How It Works

Clone or pull the repo into ~/.skill-sync-cache/ (uses gh CLI with git clone fallback)
Discover all directories containing a valid SKILL.md (supports both repo/skill-name/ and repo/skills/skill-name/ layouts)
Compare each skill's content hash against the last sync state
Install new skills, update changed skills, skip unchanged ones
Validate every SKILL.md has proper YAML frontmatter (name + description)
Save state with commit hash and per-skill content hashes for next sync

Change Detection

The script tracks content hashes to avoid unnecessary overwrites:

Source unchanged, dest unchanged - skipped (already up-to-date)
Source changed, dest unchanged - updated from repo
Source unchanged, dest changed - skipped (local changes preserved)
Both changed - skipped unless --force is used

State File

Sync state is stored at ~/.skill-sync-cache/sync_state.json. Contains last sync timestamp, commit hash, and per-skill content hashes. Delete this file to force a full re-sync.

Configuration

Paths can be overridden via environment variables or CLI flags:

Setting	Default	Override
Skills directory	`/home/ubuntu/skills`	`SKILL_ROUTER_SKILLS_DIR` or `--skills-dir`
Cache directory	`/home/ubuntu/.skill-sync-cache`	`SKILL_ROUTER_SYNC_CACHE` or `--cache-dir`

After Syncing

Skills are immediately available to compatible AI clients after syncing. Agents route skills from the target skill root using the name and description in each SKILL.md frontmatter.

What ships with it: 1 file

21.9 KB alongside SKILL.md, 1 of them executable

scripts/

sync_skills.pyruns21.9 KB