repo-sync-updater

Syncs a local Git clone with its upstream via fast-forward pulls and refreshes backend prerequisites.

174|17|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/CurryTang/Amadeus --skill repo-sync-updater
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-sync-updater
Source: https://github.com/CurryTang/Amadeus/tree/main/skills/repo-sync-updater
Command: npx skills add https://github.com/CurryTang/Amadeus --skill repo-sync-updater

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Synchronize a local or WSL clone with its upstream branch and verify backend runtime prerequisites for tracker jobs, ensuring you're always aligned and ready to run tasks.

Core Features & Use Cases

  • Safe upstream synchronization with fast-forward pulls only.
  • Dry-run mode to preview changes and avoid unintended mutations.
  • Automatic backend prerequisites refresh (npm ci and Playwright install chromium) to prevent tracker failures.
  • Dirty-workflow handling: detect dirty working trees and optional bypass with --allow-dirty.
  • Restart of backend service when updates require it.
  • Use case: diagnose drift between local and remote, then automatically bring the environment back to a healthy state.

Quick Start

Run the provided sync script on the host that runs backend tasks to align your local clone with upstream and refresh runtime prerequisites.

Frequently Asked Questions about repo-sync-updater

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

FAQPage Schema
How do I sync a local git repository with upstream and verify backend runtime readiness?

To sync a local repository with upstream, you run a script on your backend host that enforces fast-forward pulls, validates prerequisites like npm ci, and refreshes Playwright chromium installations to ensure runtime readiness for tracker tasks.

Can I preview git sync changes before applying them to my working directory?

Yes, you can preview git sync changes before applying them using the dry-run mode, which allows you to inspect upstream updates and avoid unintended mutations to your local repository working tree.

What should I do if my git working tree is dirty before a repository sync?

If your git working tree is dirty before a repository sync, the process detects the uncommitted changes and halts, but you can use the optional dirty-state bypass with the allow-dirty flag to proceed.

Does this repository sync workflow support WSL hosts for backend automation tasks?

Yes, this repository sync workflow explicitly supports WSL or similar hosts to perform safe git operations, validate prerequisites, and refresh the backend stack for production-grade automation tasks.

Why do I need to restart the backend service after pulling upstream repository updates?

You need to restart the backend service after pulling upstream repository updates because runtime dependencies and configurations may have changed, requiring a service restart to ensure a reliable, healthy synchronization state for tracker jobs.

What is the best way to prevent tracker job failures caused by outdated backend dependencies?

The best way to prevent tracker job failures from outdated backend dependencies is to automatically refresh prerequisites like running npm ci and installing Playwright chromium immediately after synchronizing your local clone with the upstream branch.