sync-skills-git

Sync Codex skill folders bidirectionally with ghostltx/codex-skills on GitHub.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you keep your personal Codex skills repository in sync across local machines, GitHub, and company devices by handling commits, pushes, tags, and releases in a single workflow.

Core Features & Use Cases

  • Synchronize skill folders to ghostltx/codex-skills with structured versioning and release notes.
  • Support Push and Pull workflows, tag creation, and optional overwrite when restoring from remote states.
  • Automate repository housekeeping, including updating README and generating versioned releases for easy rollback.

Quick Start

Run the sync-skills-git script to upload your local skill changes to the remote repository.

Frequently Asked Questions about sync-skills-git

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

FAQPage Schema
How do I sync my Codex skills across multiple devices using Git?

To sync Codex skills across devices using Git, you can automate bidirectional uploads and pulls between local folders and a GitHub repository. This handles commits, pushes, and tags in a single workflow to keep your skill versions consistent everywhere.

Can I automate Git tags and releases for my personal skill repository?

Yes, you can automate Git tags and releases for your skill repository. The workflow handles tag creation and generates versioned releases with structured notes, enabling easy rollback and repository housekeeping directly through GitHub credentials.

What do I need to set up before syncing skill folders to GitHub?

Before syncing skill folders to GitHub, you need Git and the GitHub CLI installed, a configured Git remote, and credentials or tokens for GitHub releases. The syncing process also requires the specific PowerShell sync script to execute.

How does bidirectional skill syncing handle restoring from a remote state?

Bidirectional skill syncing handles restoring from a remote state through a pull workflow that supports optional overwrites. This allows you to selectively include specific skills and overwrite local changes when restoring from the GitHub repository.

What is the best way to manage versioning for Codex skills pushed to GitHub?

The best way to manage versioning for Codex skills is to use an automated workflow that applies structured versioning and updates the README during release generation. This ensures consistent version management across local, GitHub, and company devices.

Why does syncing skills require a PowerShell script and GitHub CLI?

Syncing skills requires a PowerShell script to automate the local commit and tag operations, while the GitHub CLI is needed to authenticate credentials and manage remote repository releases. Both tools are necessary dependencies for the complete push and pull workflow.