sync-skills

Sync completed skill directories to SkillShare and tool-wide global skill roots.

Updated May 12, 2026
One-click install
npx skills add https://github.com/YeomanYe/skills --skill sync-skills-yeomanye
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-skills
Source: https://github.com/YeomanYe/skills/tree/main/sync-skills
Command: npx skills add https://github.com/YeomanYe/skills --skill sync-skills-yeomanye

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the distribution of a completed skill directory to the global SkillShare center and to other installed tool-specific global skill directories, preventing duplicates by excluding Codex root by default.

Core Features & Use Cases

  • Syncs the completed skill directory to the central SkillShare source and to detected tool-wide global skill roots.
  • Excludes ~/.codex/skills by default to avoid duplicate discovery when Codex reads other global roots.
  • Supports explicit source path or current working directory, and overwrites existing destinations by default.
  • Synchronizes to center and to other known tool global skill roots (e.g., ~/.agents/skills, ~/.claude/skills, etc.) when present.
  • Optional Feishu auto-commit when running from a Feishu session, with controlled behavior via environment variables.
  • Outputs structured results including source, destination, overwrote, and git_status.

Quick Start

Run the script scripts/sync_skill_to_center.sh with your skill directory as the source to push the skill to the global SkillShare center and all detected tool global directories.

Frequently Asked Questions about sync-skills

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

FAQPage Schema
How do I sync a completed skill directory to multiple AI tool global roots?▼

To sync a completed skill directory, run the sync script to push it from your source path to the central SkillShare source and detected tool-wide global skill directories, automatically overwriting existing destinations.

What is the best way to distribute local development skills across multiple AI tooling environments?▼

Distributing local development skills across AI tooling environments is done by syncing the completed skill directory into the central SkillShare source and other detected global skill roots like ~/.claude/skills.

Does the skill sync process exclude the Codex global root by default?▼

Yes, the skill sync process excludes the ~/.codex/skills root by default to prevent duplicate discovery, since Codex is capable of reading skills from other detected global roots.

How do I verify a skill is ready before syncing it to global tool directories?▼

To verify a skill is ready for syncing, ensure the SKILL.md file is present in your directory; the sync script checks for this file, derives the skill name, and proceeds only if validation passes.

Can I auto-commit synced skills to Git when running from a Feishu session?▼

Yes, you can auto-commit synced skills to Git when running from a Feishu session, with the commit behavior controlled by specific environment variables during the sync execution.

What happens to existing skills in the destination directory when a conflict occurs during sync?▼

When a conflict occurs during the skill sync, the script overwrites existing files in the destination directories by default, ensuring the central SkillShare source and global roots have the latest version.