sync-dotfiles

Synchronize Cursor configuration files with a chezmoi-managed dotfiles repository.

1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/luigiinred/dotfiles --skill sync-dotfiles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-dotfiles
Source: https://github.com/luigiinred/dotfiles/tree/main/dot_cursor/skills/sync-dotfiles
Command: npx skills add https://github.com/luigiinred/dotfiles --skill sync-dotfiles

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the synchronization of your Cursor configuration (skills, agents, rules) with your central dotfiles repository managed by chezmoi, ensuring consistency across your development environment.

Core Features & Use Cases

  • Update Dotfiles: Fetches the latest changes from your remote dotfiles repository and applies them to your local environment.
  • Sync/Push Dotfiles: Captures local changes made within Cursor's configuration directories and pushes them to your remote repository.
  • Use Case: After adding a new custom agent to Cursor, use this Skill to automatically commit and push these changes to your GitHub dotfiles repository.

Quick Start

Use the sync-dotfiles skill to update your dotfiles from the remote repository.

Frequently Asked Questions about sync-dotfiles

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

FAQPage Schema
How do I sync my Cursor configuration files to a dotfiles repository using chezmoi?

To sync your Cursor configuration files, this skill captures local changes to skills, agents, and rules, then pushes them to your chezmoi-managed dotfiles repository. It automates the git integration within the source directory.

What is the best way to update local Cursor configurations from a remote dotfiles repository?

The best way to update local configurations is by fetching the latest changes from your remote dotfiles repository. This skill applies those remote updates directly to your local Cursor environment using chezmoi atomic operations.

Do I need chezmoi installed to automate syncing my development environment configurations?

Yes, you need chezmoi installed to automate syncing your configurations. The skill requires chezmoi to facilitate atomic operations and manage git integration within the source directory for consistent updates.

Can I use this skill to push custom Cursor agents back to my GitHub dotfiles repository?

Yes, you can push custom Cursor agents back to your GitHub repository. After adding a new agent locally, this skill automatically captures the modifications and commits and pushes them to your remote dotfiles source.

How does dotfile synchronization work for Cursor skills and rules across different machines?

Dotfile synchronization works by pulling remote repository updates to local environments and pushing local modifications back. This ensures your Cursor skills and rules remain consistent across all your development machines via git.

What are the limitations of using git to manage Cursor configuration files?

A limitation is that managing Cursor configuration files requires chezmoi for atomic operations. Without proper chezmoi integration, pushing local modifications directly through git within the source directory may fail or cause inconsistent state.