skills-sync

Sync local skills with an upstream agent-skills repository via rsync.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/grahama1970/fetcher --skill skills-sync-grahama1970
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-sync
Source: https://github.com/grahama1970/fetcher/tree/main/.agents/skills/skills-sync
Command: npx skills add https://github.com/grahama1970/fetcher --skill skills-sync-grahama1970

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rsync, git.

What problem does it solve?

Syncing local skill definitions across projects can be error-prone and time-consuming when done manually. This Skill provides a reliable mechanism to keep the local .agents/skills directory in sync with an upstream canonical repository, enabling consistent skill sharing.

Core Features & Use Cases

  • Rsync-based push/pull between local and upstream repos to automate updates.
  • Optional fanout to multiple projects to propagate changes across teams.
  • Auto-commit and push in the upstream repo after a successful sync (configurable).
  • Quick discovery and status reporting via an info command to show paths and health.

Quick Start

Run the skills-sync script with push to synchronize local skills to the upstream repository.

Frequently Asked Questions about skills-sync

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

FAQPage Schema
How do I sync local agent skills with an upstream repository?

You can sync local skills with an upstream repository using rsync-based push and pull commands, which automate updates between your local .agents/skills directory and the canonical repo to ensure consistent skill sharing across projects.

What is the best way to automate skill sharing across multiple projects?

Automating skill sharing across projects is handled through an optional fanout feature, which propagates rsync updates from the upstream repository to multiple local project directories simultaneously, keeping all teams aligned.

Do I need rsync and git installed to synchronize local skills?

Yes, you need both rsync and git installed to use this sync mechanism, as it relies on rsync for data transfer and git for auto-committing and pushing changes in the upstream repository after a successful synchronization.

Can I automatically commit and push upstream skill changes after syncing?

Yes, auto-commit and push in the upstream repo is a configurable feature that triggers automatically after a successful sync, ensuring your canonical skill definitions are version-controlled and updated without manual git operations.

How do I check the status and paths of my local and upstream skill directories?

You can check the status and paths of your skill directories by running the info command, which provides a quick discovery report showing your configured local and upstream directories alongside their current health status.

What environment variables are required to configure local and upstream skill syncing?

Configuring local and upstream skill syncing requires environment variables to control the local directory and upstream paths, along with a properly configured upstream path and rsync installed to execute the push and pull operations.