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.