yadm-sync

Automate yadm version control and synchronization of dotfiles.

3|1|Updated Jun 20, 2016
One-click install
npx skills add https://github.com/paulchiu/dotfiles --skill yadm-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yadm-sync
Source: https://github.com/paulchiu/dotfiles/tree/main/.config/opencode/skills/yadm-sync
Command: npx skills add https://github.com/paulchiu/dotfiles --skill yadm-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing and syncing dotfiles across multiple machines is error-prone and manual. This Skill automates the lifecycle of dotfile changes by using yadm to stage, commit, and push updates to dotfiles stored in home directories such as ~/.claude and ~/.config/opencode/skills.

Core Features & Use Cases

  • Dotfile lifecycle automation: add, commit, and push changes to tracked and new files under yadm management.
  • Safe workflow guidance: explicit steps to inspect changes with yadm status, yadm diff, and yadm log before staging.
  • Use Case: keep key dotfiles in sync across devices, including yadm-managed paths like ~/.claude and ~/.config/opencode/skills.

Quick Start

Stage your changes with yadm add <path>, then commit with yadm commit and push with yadm push.

Frequently Asked Questions about yadm-sync

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

FAQPage Schema
How do I automate dotfile synchronization across multiple machines using yadm?

Automate dotfile synchronization by using yadm to stage, commit, and push updates to tracked files. The workflow checks status, diff, and log before staging explicit paths, then generates conventional-commits style messages and pushes changes to keep devices in sync.

What is the safest workflow for committing dotfile changes with yadm?

The safest workflow for dotfile changes requires inspecting updates with yadm status, yadm diff, and yadm log before staging. Explicitly staging specific paths ensures only intended changes are committed, preventing accidental tracking of sensitive files in your home directory.

Does yadm automation support conventional-commits style messages for dotfile version control?

Yes, yadm automation supports conventional-commits style messages for dotfile version control. It automatically generates these structured commit messages during the staging and commit lifecycle to maintain a clean, readable history for your configuration files.

Can I use this to track new files added to ~/.claude and ~/.config directories?

Yes, you can track new files added to ~/.claude and ~/.config directories. The automation targets these specific yadm-managed paths, ensuring that new dotfiles within these directories are staged, committed, and pushed to your remote repository.

Do I need any special dependencies installed to automate dotfile updates?

You need yadm availability installed to automate dotfile updates. The automation requires the yadm tool to execute version control commands like add, commit, and push, ensuring your dotfiles are properly tracked and synchronized across machines.

Why should I use yadm instead of standard git for managing home directory configuration files?

You should use yadm instead of standard git for managing home directory configuration files because yadm is specifically designed to track dotfiles without requiring a separate repository folder. It acts as a wrapper around git, providing targeted dotfile lifecycle automation.