convention-sync

Synchronize local development files with a canonical remote repository using git, gh CLI, and jq.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/EdgeApp/edge-dev-agents --skill convention-sync-edgeapp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convention-sync
Source: https://github.com/EdgeApp/edge-dev-agents/tree/main/.cursor/skills/convention-sync
Command: npx skills add https://github.com/EdgeApp/edge-dev-agents --skill convention-sync-edgeapp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, jq, rsync, and includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of configuration drift between a developer's local environment and a shared repository, ensuring that rules, skills, and orchestration settings remain consistent across machines.

Core Features & Use Cases

  • Canonical Syncing: Maintains the local ~/.cursor directory as the source of truth while mirroring changes to the edge-dev-agents repository.
  • Cross-Machine Safety: Prevents accidental overwrites or deletions by performing content-hash comparisons and blocking operations when local environments are stale.
  • Orchestration Projection: Automatically manages shared Claude memories and hook registrations to ensure agent-watcher systems function identically on every machine.

Quick Start

Run the convention-sync skill to dry-run the current status of your local cursor configuration against the repository.

Frequently Asked Questions about convention-sync

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

FAQPage Schema
How do I sync local cursor rules and scripts with a remote git repository?

Syncing local cursor configuration uses content-hash comparisons to mirror files to a remote repository, blocking operations when local environments are stale to prevent data loss and ensure cross-machine consistency.

What is configuration drift in local development environments?

Configuration drift happens when local environment files diverge from a shared repository, causing shared Claude memories and hook registrations to function inconsistently across different machines and breaking orchestration projection.

Do I need gh CLI and jq installed to sync my local cursor setup?

Yes, syncing your local cursor setup requires gh CLI and jq to execute version control operations and perform JSON-based state validation, alongside git and rsync for managing bidirectional file transfers.

Can I dry-run a configuration sync before overwriting local files?

Yes, you can dry-run the configuration sync to check the current status of your local cursor setup against the repository, reviewing file differences before executing any bidirectional transfers or overwrites.

How does content hashing prevent stale configuration overwrites?

Content hashing prevents stale configuration overwrites by comparing file states between the local environment and remote repository, blocking sync operations when local files are outdated to ensure cross-machine safety and data integrity.

What's the best way to manage shared Claude memories across multiple machines?

The best way to manage shared Claude memories across machines is through orchestration projection, which automatically manages hook registrations to ensure agent-watcher systems function identically on every machine via canonical syncing.