sync-private-skills

Reconcile authored skills across three private skill homes with user-confirmed diffs.

1|Updated May 30, 2026
One-click install
npx skills add https://github.com/FixPortal/fixportal-claude-skills --skill sync-private-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-private-skills
Source: https://github.com/FixPortal/fixportal-claude-skills/tree/main/skills/sync-private-skills
Command: npx skills add https://github.com/FixPortal/fixportal-claude-skills --skill sync-private-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconciles authored skills across three private homes to resolve drift and keeps configurations aligned.

Core Features & Use Cases

  • Detects drift across Claude Code, Codex/Copilot, and Antigravity skill folders.
  • Proposes user-confirmed synchronization actions and maintains a last-sync manifest for audit.
  • Ensures safe, manual-controlled merges with explicit confirmation before any cross-home copy.

Quick Start

Run audit-skills to identify drift, then run this skill to reconcile diffs after reviewing the proposed plan.

Frequently Asked Questions about sync-private-skills

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

FAQPage Schema
How do I reconcile private skills drift across Claude Code, Codex, and Antigravity homes?

To reconcile private skills drift, you need a controlled sync process that compares directories like ~/.claude/skills and ~/.gemini/config/skills/, shows file diffs, and applies changes only after explicit user confirmation.

What is the safest way to sync configuration files across multiple agent directories?

The safest way to sync configuration files across multiple agent directories is a manual-controlled merge that displays a diff of proposed changes and requires explicit confirmation before copying any files to prevent unwanted overwrites.

How does a last-sync manifest help audit multi-home skill configurations?

A last-sync manifest records the state of synchronized files at the time of the last merge, providing a baseline snapshot to compare against during future audits to quickly identify new configuration drift.

Can I automatically copy files between ~/.claude/skills and ~/.agents/skills without manual review?

No, this synchronization process requires explicit user confirmation before any cross-home copy occurs, ensuring you review the proposed diff and maintain manual control over all merges to prevent accidental data loss.

When do I need to synchronize skill folders across different AI homes?

You need to synchronize skill folders when you detect drift between your authored skills in separate homes, which happens when files in ~/.claude/skills, ~/.agents/skills, or ~/.gemini/config/skills/ are edited independently.

What's the best way to audit skills and resolve directory drift before running a sync?

The best way to audit skills and resolve drift is to first run an audit process to identify the discrepancies, then review the proposed synchronization plan and confirm the diffs before executing the file copy.