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.