sync-status

Check dotfiles synchronization across machines via git status, stow symlinks, plugins, and settings templates.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/stitts-dev/dotfiles --skill sync-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-status
Source: https://github.com/stitts-dev/dotfiles/tree/main/.claude/skills/sync-status
Command: npx skills add https://github.com/stitts-dev/dotfiles --skill sync-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive overview of your dotfiles synchronization status across different machines, identifying discrepancies in git status, stow symlinks, plugin installations, and configuration settings.

Core Features & Use Cases

  • Git Status Check: Verifies branch, commit ahead/behind remote, and uncommitted changes.
  • Stow Symlink Integrity: Ensures all managed dotfiles are correctly symlinked and not overwritten by regular files. Detects broken symlinks.
  • Plugin Drift Detection: Compares expected plugins from a list against installed plugins.
  • Settings Template Validation: Checks active settings against a template for hooks, deny rules, and environment variables.
  • Inventory Count: Reports the number of agents, skills, hooks, and hookify rules.
  • Use Case: Before making system changes, run this Skill to ensure your development environment is consistently configured across all your machines.

Quick Start

Run the sync-status skill to get a report on your dotfiles synchronization.

Frequently Asked Questions about sync-status

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

FAQPage Schema
How do I check if my dotfiles are synced across multiple machines?

You can check dotfiles synchronization by verifying git status, stow symlink integrity, plugin drift, and settings template compliance to generate a detailed diagnostic dashboard report.

What does stow symlink integrity verification detect?

Stow symlink integrity verification detects managed dotfiles that are incorrectly symlinked, overwritten by regular files, or broken, ensuring your configuration links remain valid across machines.

How do I detect plugin drift in my dotfiles repository?

You detect plugin drift by comparing a list of expected plugins against the currently installed plugins, highlighting any missing or unauthorized additions in your configuration environment.

Can I validate configuration settings against a template for hooks and environment variables?

Yes, settings template validation checks active configuration settings against a predefined template to ensure compliance for hooks, deny rules, and environment variables across your machines.

When should I run a dotfiles synchronization status check?

You should run a dotfiles synchronization status check before making system changes to ensure your development environment is consistently configured and identify discrepancies across all your machines.