git-package-sync

Synchronize local Git repositories with GitHub via subtree or standalone pushes.

4|2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/0xKobold/0xkobolds --skill git-package-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-package-sync
Source: https://github.com/0xKobold/0xkobolds/tree/main/packages/pi-kobold/.pi/skills/git-package-sync
Command: npx skills add https://github.com/0xKobold/0xkobolds --skill git-package-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and automates syncing local Git repositories with GitHub, enabling both subtree-based multi-repo workflows and standalone repos to stay in sync with minimal manual setup.

Core Features & Use Cases

  • Subtree push/pull to align subdirectories with separate GitHub repos in monorepos.
  • Standalone repo sync to push and pull changes directly to GitHub.
  • Manage issues and pull requests across any target repo.
  • Worktree support for isolated development without altering the main workspace.
  • Auto-detection and optional persistent configuration via .git-sync.json.

Quick Start

Initialize a new project and push its subtree to GitHub.

Frequently Asked Questions about git-package-sync

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

FAQPage Schema
How do I sync a monorepo subdirectory to a separate GitHub repository?

Git subtree sync aligns monorepo subdirectories with separate GitHub repositories by pushing and pulling subtree splits. It automatically detects the repository layout to manage multi-repo workflows with minimal manual setup.

Can I manage GitHub issues and pull requests across multiple standalone repos?

Yes, you can manage cross-repo issues and pull requests across standalone repos or subtree targets. The workflow synchronizes local Git repositories with GitHub, enabling issue and PR management directly across any target repository.

Do I need the GitHub CLI installed to sync local Git repositories?

Yes, git and the GitHub CLI are required for full functionality to sync local repositories. The workflow auto-detects mode from repository layout or a .git-sync.json file, utilizing these dependencies for subtree pushes and PR management.

What is the best way to isolate development branches without altering the main workspace?

Git worktree support isolates development branches without altering the main workspace during repository sync. This enables parallel branch management alongside subtree push and pull operations for monorepos and standalone projects.

Does git-package-sync work with configurable options like org, prefix, and defaultBranch?

Yes, the sync workflow supports configurable options including org, prefix, pattern, and defaultBranch. These settings can be defined persistently via a .git-sync.json file or applied dynamically during subtree and standalone repository synchronization.

Why use git subtree instead of submodules for monorepo synchronization?

Git subtree synchronization merges subdirectory history directly into parent commits, avoiding the detached state complexities of submodules. This approach maintains a unified commit history while pushing subdirectories to separate GitHub repositories.