mcpField
S
skill-sync

skill-sync

github.com/maddec01Agent workflows116 installsUpdated today
Repository

About skill-sync

A skill for syncing copied skills in maddec01/mux-factory with their upstream versions. It provides a review-and-approval process that records selected changes and preserves skipped updates for later review.

Key features

  1. 01Checks upstream changes against recorded commits
  2. 02Summarizes changes and recommendations for review
  3. 03Applies only approved files or hunks
  4. 04Tracks sync points in UPSTREAM.md

Use cases

  1. 01Review upstream skill updates
  2. 02Select changes for a factory repository
  3. 03Prepare a sync pull request

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/maddec01/mux-factory --skill skill-sync

After installing, type/skill-syncin Claude Code to confirm it loaded.

Bundled filesscripts/upstream-changes.sh

Details

From the project README

The copied skills in maddec01/mux-factory change only through this skill. UPSTREAM.md records the upstream commit each copy matches.

  1. Work in a fresh branch chore/skill-sync-<date> of the mux-factory checkout (~/Developer/Mux/mux-factory), updated from origin/main.
  2. Run bash <this skill>/scripts/upstream-changes.sh <checkout>. It prints, per copy, whether upstream changed since the recorded commit, the upstream commits and the diff.
  3. For each changed copy, summarise in two or three lines what changed and what it would do to the factory, and give your recommendation (take, skip, or take part). Ask Pedro to pick, using numbered questions so he can answer in one message. Ask whether he wants any new upstream skills copied too.
  4. Apply exactly what he picked: copy the upstream files over the copy (or apply the chosen hunks), and set that row's commit in UPSTREAM.md to the upstream commit you took. A skipped change keeps the old commit, so it shows up again next time; say so.
  5. Commit as chore(skills): sync <names> from upstream, push, and open a PR listing what was taken and skipped. Pedro merges it.
  6. Tell him to pull main after merging and run bash scripts/install.sh. It updates the skills and the checklists in references/.

Never edit a copy for Mux reasons. Mux rules belong in mux-work or a repo's AGENTS.md.

Comments

Markdown supported