gcp-custom-skills-sync

Syncs custom agent skills to a private GitHub repository using rsync and git.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/ricardolui/gcp-custom-agent-skills --skill gcp-custom-skills-sync-ricardolui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gcp-custom-skills-sync
Source: https://github.com/ricardolui/gcp-custom-agent-skills/tree/main/gcp-custom-skills-sync
Command: npx skills add https://github.com/ricardolui/gcp-custom-agent-skills --skill gcp-custom-skills-sync-ricardolui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Custom agent skills created or modified locally can be lost or become inconsistent across environments without a backup process. This Skill provides a repeatable workflow to mirror custom skills into a local git clone and push them to a private GitHub repository for version control and recovery. ## Core Features & Use Cases - Skill Backup Workflow: Mirrors non-symlinked custom skill directories from the active skills folder into a local git clone using rsync. - Git Synchronization: Stages, commits, and pushes skill changes to the private GitHub repository 'gcp-custom-agent-skills'. - Selective Tracking: Automatically ignores standard system or bundled symlinked skills, tracking only custom, unique skills. - Use Case: After creating a new custom skill in the active skills directory, run this workflow to copy it into the git clone, commit with a descriptive message, and push to GitHub so the skill is backed up and versioned. ## Quick Start Back up and sync my newly modified custom skills to the GitHub repository now.

Frequently Asked Questions about gcp-custom-skills-sync

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

FAQPage Schema
How do I back up custom agent skills to GitHub?

Mirror the custom skill directories from the active skills folder into the local git clone using rsync, then run git add, commit, and push from the clone directory. This uploads the skills to the private GitHub repository for versioned backup.

How do I add a new custom skill to the sync workflow?

Create a new directory under the active skills folder, add a SKILL.md file with YAML frontmatter containing name and description, then mirror it to the local git clone and push the changes to GitHub following the standard sync workflow.

Does the sync include system or bundled skills?

No, the git tracking model only covers custom, unique, non-bundled skills. Standard system or bundled skills that exist as symlinks are automatically ignored and never copied into the repository.

Why are symlinked skills excluded from the backup?

Symlinked skills point to standard system or bundled resources that already exist elsewhere, so copying them would duplicate content and pollute the repository. Only real custom skill directories are mirrored with rsync.

What are the limitations of this git-based skill backup?

The workflow uses hardcoded local paths and a single private repository, so it only works on the configured machine. It also requires manual execution of rsync and git commands rather than running automatically on every skill change.