sync

Stage, commit, and push dotfiles changes to GitHub.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Z5Jonathan-maker/ai-coding-os --skill sync-z5jonathan-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/Z5Jonathan-maker/ai-coding-os/tree/main/claude/skills/sync
Command: npx skills add https://github.com/Z5Jonathan-maker/ai-coding-os --skill sync-z5jonathan-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents your local dotfiles from drifting away from your GitHub repository by automating the stage, commit, push, and verification cycle.

Core Features & Use Cases

  • Stages and commits your dotfiles changes automatically, ensuring updates are captured even when you don’t provide a message.
  • Pushes to the configured GitHub repository so your latest configuration is available on other machines.
  • Verifies commit status by reporting the resulting commit SHA and commit.verification from the GitHub API.

Quick Start

Run sync to commit and push any changes in your ~/dotfiles directory to GitHub, using your provided message or an auto-generated one.

Frequently Asked Questions about sync

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

FAQPage Schema
How do I automatically sync dotfiles to GitHub?

To sync dotfiles to GitHub, run the sync command from your ~/dotfiles directory to automatically stage changes, create a commit, and push updates to the remote repository.

What happens if I push dotfiles without providing a commit message?

If you push dotfiles without a commit message, the sync process auto-generates one derived from the diff, ensuring your configuration updates are still captured and committed.

Does this dotfiles sync tool require a clean working tree?

Yes, syncing dotfiles requires detecting a clean working tree before committing and pushing changes to your GitHub repository to ensure a stable update cycle.

Can I verify my dotfiles commit status on GitHub after pushing?

Yes, after pushing dotfiles, the tool reports the verification status by checking the resulting commit SHA and verification details directly from the GitHub API.

Why should I use an automated sync for dotfiles instead of manual git commands?

Automated dotfiles sync prevents your local configurations from drifting away from the GitHub repository by streamlining the stage, commit, push, and verification cycle into one step.

Do I need to run the sync from a specific directory?

Yes, you must run the sync command from the ~/dotfiles directory so it can correctly detect changes, stage them, and push to your configured GitHub remote.