sync-skills

Sync shared skill directories from a remote Git repository into local Claude Code and Codex skill folders.

1|2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill sync-skills-parisgroup-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skills
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/meta/sync-skills
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill sync-skills-parisgroup-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a fast, repeatable way to synchronize community-maintained AI skills from a central Git repository into the local skill directories used by Claude Code and Codex, eliminating manual copying and stale caches.

Core Features & Use Cases

  • Automatic cache management: Clones the repo to ~/.ai-skills-cache or pulls updates if the cache is older than 24 hours.
  • Tool detection and targeted install: Detects ~/.claude and ~/.agents and copies skills into the appropriate skill folders for Claude Code and Codex.
  • Selective and meta syncing: Supports syncing all skills or a specified subset and always ensures meta-skills (like sync-skills and share-skill) are updated.
  • Reporting and error handling: Summarizes which tools were detected, which skills and meta-skills were synced, and any missing requested skills.

Quick Start

Run the sync-skills meta-skill to refresh the cache and copy selected or all skills into your detected AI tool skill 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 shared AI skills from a Git repository to local Claude Code directories?

To sync shared AI skills, the Skill clones or pulls a remote Git repository into a local cache, then copies the skill files directly into your ~/.claude/skills and ~/.agents/skills directories for Claude Code and Codex.

Does syncing skills to Claude Code and Codex require a specific shell environment?

Syncing skills to Claude Code and Codex requires a Bash-compatible shell, network connectivity, Git access, and write permissions to the local target skill directories to execute cloning and file operations.

How often does the AI skills cache update when syncing from a remote Git repo?

The AI skills cache updates automatically by cloning the Git repository on first run, then pulling updates if the local cache is older than 24 hours to prevent stale skill files.

Can I selectively sync a subset of skills instead of copying the entire repository?

You can selectively sync a specified subset of skills from the repository, while meta-skills like sync-skills and share-skill are always updated automatically to ensure core functionality.

What happens if a requested skill is missing during the Git sync process?

During the Git sync process, the Skill's error handling reports a summary of which tools were detected, which skills were synced, and explicitly lists any missing requested skills that were not found.

Why use a dedicated Git sync tool instead of manually copying skills to ~/.claude/skills?

Using a dedicated Git sync tool eliminates manual copying and stale caches by providing a repeatable, automated way to detect installed tools and synchronize community-maintained AI skills directly.