Mirror sync

Skill neurawork-git/n8n-autopilot/skills/mirror-sync

Pull every remote-only n8n workflow into the local repo so it mirrors the instance, via a deterministic JS Workflow (discover remote-only → fan-out pull → verify). Establishes and refreshes the local-first invariant that /n8n-autopilot:build-workflow-v2's edit flow relies on. Auto-triggered by the SessionStart drift probe (check-mirror-drift.sh) and run as the final step of init-repo.From its SKILL.md

Install

npx -y skills add neurawork-git/n8n-autopilot --skill mirror-sync

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, as published. Nobody here has run it

Mirror Sync — pull all remote-only workflows

Make the local repo a complete mirror of the instance's workflows. n8nac has no pull-all; this skill drives the list --json → per-id pull loop deterministically via a Workflow script (fan-out, no silent cap, verified).

Why this exists

The edit flow of /n8n-autopilot:build-workflow-v2 is local-first — it assumes every remote workflow already has a local .workflow.ts. Nothing established that invariant before (init pulled schemas, never workflows). This skill is the enforcement: it pulls the gap and the SessionStart probe keeps it honest.

How to run

Invoke the script via the Workflow tool (runs in the consumer-repo cwd so npx n8nac resolves the pinned project + sync folder):

Workflow({ scriptPath: "<plugin>/skills/mirror-sync/sync.workflow.js" })

Then render the result:

{ status:'success', pulled, mirrorComplete:true } — report how many pulled (0 = already complete).
{ status:'partial', failed:[…], remoteOnlyRemaining } — list the failed ids + reasons; suggest a re-run or a manual npx n8nac pull <id>.

Watch live progress with /workflows.

Phases (in the script)

Discover — n8n-mirror runs npx n8nac list --json and returns the remote-only set (status matches /REMOTE/i — vocabulary-robust across n8nac versions — and not archived). Zero remote-only → returns early, mirror already complete.
Pull — fan-out: one n8n-mirror agent per missing workflow runs npx n8nac pull <id>. Failures are collected, not fatal.
Verify — re-discover; remoteOnlyRemaining === 0 ⇒ mirrorComplete.

Triggers

Source	Mechanism
SessionStart	`scripts/check-mirror-drift.sh --quiet` emits `AUTOPILOT_ACTION_REQUIRED: /n8n-autopilot:mirror-sync` only when remote-only workflows exist (no blind every-session pull).
init-repo	Step 6.5 runs this after schemas, so a fresh repo starts as a full mirror.
Manual	`/n8n-autopilot:mirror-sync` any time.

Boundaries

Workflows only. Node schemas are a separate concern (check-schema-versions.sh → /n8n-autopilot:pull-schemas); this skill does not duplicate them.
Pull only — never push/resolve/delete. Archived workflows are skipped (read-only).
Large instances: fan-out is capped at ~10 concurrent by the Workflow runtime; all queued workflows still complete. The pull list is logged in full — no silent truncation.