sync

Detect drift between project files and auto-engineer templates with interactive pull, push, diff, and skip choices.

5|1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/dburkart/auto-engineer --skill sync-dburkart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/dburkart/auto-engineer/tree/main/.claude/skills/sync
Command: npx skills add https://github.com/dburkart/auto-engineer --skill sync-dburkart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents your seeded auto-engineer project from drifting away from the repo’s template definitions, reducing breakage from mismatched skills, Docker settings, and helper scripts.

Core Features & Use Cases

  • Two-way drift detection: Compares skills, Dockerfile, and scripts between the target project and the auto-engineer templates.
  • Interactive per-file resolution: For each divergence, lets you choose whether to pull template updates into the target, push local changes back to templates, or view a diff and skip.
  • Safety-guarded pushes: Warns before pushing anything that might include resolved project-specific placeholder values.

Quick Start

Run /sync and provide the absolute path to your seeded project to review diffs and selectively sync skills, Dockerfile, and scripts.

Frequently Asked Questions about sync

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

FAQPage Schema
How do I keep my seeded project in template sync after manual edits?

Template sync detects drift between your seeded project's files and repository templates, allowing you to interactively pull updates, push local changes, or skip divergences. It compares skills, Dockerfiles, and scripts to prevent breakage from mismatched configurations.

What's the best way to compare Dockerfile drift between a local project and template definitions?

Dockerfile drift is detected using deterministic file comparison logic that treats resolved placeholders like {{TOOLCHAIN_SETUP}} as expected. The sync process compares your local Dockerfile against auto-engineer repository templates to identify divergences for interactive resolution.

Can I push local script modifications back to repository templates without overwriting placeholders?

Yes, you can push local script changes back to templates, but safety guards warn before pushing anything that might include resolved project-specific placeholder values. Explicit confirmation is required to prevent unsafe template pushes that could corrupt template definitions.

Does template sync work with YAML-defined discovery metadata for configuration reconciliation?

Yes, template sync requires YAML-defined discovery metadata to perform configuration reconciliation. This metadata enables the tool to discover and compare skills, Dockerfiles, and scripts between your target project and auto-engineer templates for two-way diff detection.

How do I resolve configuration drift when my .claude/ files differ from template definitions?

Configuration drift in .claude/ files is resolved through interactive per-file choices. For each divergence found between your project and templates, you can pull template updates into the target, push local changes back, view a diff, or skip the file entirely.

Why does my synced Dockerfile show placeholder values instead of template variables after updating templates?

Resolved Dockerfile placeholders like {{TOOLCHAIN_SETUP}} are treated as expected values during comparison. The sync logic recognizes these resolved project-specific placeholders to avoid false drift detection when comparing your local Dockerfile against template definitions.