About

Imported from stitts-dev/dotfiles (.claude/skills/sync-fix/SKILL.md). Install upstream with npx skills add stitts-dev/dotfiles --skill sync-fix. Copyright stays with the author.

Sync Fix

Name: sync-fix
Author: stitts-dev

Resolve all dotfiles sync issues in a single pass. Dispatch a background agent to handle the fixes while the user continues working.

Process

Step 1: Run `/sync-status` first

Before fixing anything, invoke the sync-status skill to get the current state. If you already have recent sync-status output from this session, skip this step.

Step 2: Dispatch background fix agent

Launch an Agent with run_in_background: true to perform the fixes. The agent should run the following steps sequentially, stopping on critical failures.

Agent prompt template:

You are fixing dotfiles sync issues. Run each step sequentially. Report results as JSON.

Step 1 — Pull latest dotfiles:
  cd ~/.dotfiles && git stash && git pull --rebase origin main && git stash pop 2>/dev/null || true

Step 2 — Restow symlinks:
  cd ~/.dotfiles && stow --restow --target ~ .

Step 3 — Install missing plugins:
  bash ~/.claude/hooks/sync-plugins.sh --import

Step 4 — Export new plugins to plugins.txt:
  bash ~/.claude/hooks/sync-plugins.sh --export

Step 5 — Merge settings template:
  bash ~/.dotfiles/setup-claude.sh

Step 6 — Verify fix:
  bash ~/.claude/hooks/sync-check.sh

After each step, report what changed. If step 1 has merge conflicts, STOP and report — do not force resolve.

Step 3: Report results

When the background agent completes, summarize:

## Sync Fix Results

| Step | Status | Details |
|------|--------|---------|
| Git pull | OK / CONFLICT | pulled 3 commits |
| Stow restow | OK / WARN | 2 new symlinks created |
| Plugin install | OK | installed 1 missing plugin |
| Plugin export | OK | added 0 new to plugins.txt |
| Settings merge | OK | added SessionStart hook |
| Verification | CLEAN / DRIFT | (remaining issues) |

### Remaining Issues
- (any issues that couldn't be auto-fixed)

### Manual Steps Needed
- (e.g., resolve merge conflicts, re-authenticate gh CLI)

Safety

Git conflicts: Do NOT force-resolve. Stash local changes, attempt rebase. If conflicts arise, stop and report.
Settings merge: The setup-claude.sh script is additive — it won't remove existing config.
Plugin install: Idempotent — safe to re-run.
Stow restow: Will warn on conflicts but won't overwrite non-symlinked files.

When to Use

After /sync-status shows issues
When switching machines (first session of the day)
After pulling dotfiles changes manually
When the SessionStart hook reports drift

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/stitts-dev-dotfiles-sync-fix/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

stitts-dev-dotfiles-sync-fix.ocm.jsonjson

{
  "ocm": "1",
  "id": "stitts-dev-dotfiles-sync-fix",
  "kind": "skill",
  "name": "sync-fix",
  "description": "Fix dotfiles sync issues — pull changes, restow, install missing plugins, merge settings template. Runs in background.",
  "publisher": "stitts-dev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "dotfiles",
      "sync",
      "maintenance",
      "fix",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Fix dotfiles sync issues — pull changes, restow, install missing plugins, merge settings template. Runs in background."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/stitts-dev/dotfiles",
      "path": ".claude/skills/sync-fix/SKILL.md",
      "ref": "f7da603539f7536c3f79a680d12e7e0be02957df",
      "url": "https://github.com/stitts-dev/dotfiles/blob/f7da603539f7536c3f79a680d12e7e0be02957df/.claude/skills/sync-fix/SKILL.md",
      "key": "stitts-dev/dotfiles/.claude/skills/sync-fix/SKILL.md"
    }
  },
  "instructions": "# Sync Fix\n\nResolve all dotfiles sync issues in a single pass. Dispatch a background agent to handle the fixes while the user continues working.\n\n## Process\n\n### Step 1: Run `/sync-status` first\n\nBefore fixing anything, invoke the `sync-status` skill to get the current state. If you already have recent sync-status output from this session, skip this step.\n\n### Step 2: Dispatch background fix agent\n\nLaunch an Agent with `run_in_background: true` to perform the fixes. The agent should run the following steps sequentially, stopping on critical failures.\n\n**Agent prompt template:**\n\n```\nYou are fi",
  "cost": {
    "context_tokens": 620
  }
}

Fetch it by URL: GET /api/v1/registry/stitts-dev-dotfiles-sync-fix/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.