Agent skill

Sync Parity Worker

by arul28 in arul28/ADE

Extends ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work

AGPL-3.0Auto-check passedMobile

Install Sync Parity Worker

skills CLI
$ npx skills add arul28/ADE --skill sync-parity-worker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install arul28/ADE sync-parity-worker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/arul28/ADE.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.factory/skills/sync-parity-worker .claude/skills/sync-parity-worker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sync-parity-worker
GitHub stars
114
Token cost
~1.8k tokens
SKILL.md length
550 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Extends ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work

  • Works in 8 steps: Understand the contract gap → Plan all touched files before coding → Write tests first (red) → …
  • Tasks that involve iOS development
  • SKILL.md covers When to Use This Skill, Work Procedure, Example handoff and When to Return to Orchestrator
  • Calls npm and xcodebuild

What it does

Sync Parity Worker is an agent skill from arul28/ADE. Extends ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering iOS development. It works with iOS. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve iOS development

Example prompts

  • “Use the sync-parity-worker skill to extend ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work”
  • “/sync-parity-worker”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Understand the contract gap
  2. Plan all touched files before coding
  3. Write tests first (red)
  4. Implement the contract change (green)
  5. Preserve offline and capability behavior
  6. Verify both stacks
  7. Manual verification
  8. Commit

What it can do on your machine

Read from SKILL.md and the folder at commit fbbd974. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • xcodebuild

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sync Parity Worker loads about 1.8k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 550 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from arul28/ADE at commit fbbd974, republished under its AGPL-3.0 licence (© arul28). 550 words, ~1,753 tokens.

Download SKILL.mdSave it as .claude/skills/sync-parity-worker/SKILL.md (or your agent's skills folder).
name
sync-parity-worker
description
Extends ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work

Sync parity worker

NOTE: Startup and cleanup are handled by worker-base. This skill defines the WORK PROCEDURE.

When to Use This Skill

Use this skill when a feature requires changes outside pure SwiftUI/UI work, including:

  • desktop ADE sync-host or main-process service changes under apps/desktop/src/main/
  • desktop shared contract or payload changes under apps/desktop/src/shared/
  • iOS SyncService.swift, RemoteModels.swift, or Database.swift
  • cached projection or hydration changes needed for Work, Files, PRs, Settings, or Lanes parity
  • backend support for mobile-only parity gaps such as missing actions, missing payload fields, or missing cross-tab navigation data

Do not use this skill for pure SwiftUI refactors or visual polish that can stay entirely inside the iOS app.

Work Procedure

1. Understand the contract gap

Read the feature description, then:

  • Read mission.md and AGENTS.md
  • Read .factory/library/architecture.md, .factory/library/tab-parity.md, and .factory/library/user-testing.md
  • Trace the full path for the feature: desktop service → shared types/payloads → iOS models/service → cached database projections → consuming UI
  • Identify the smallest contract change that closes the parity gap
2. Plan all touched files before coding

List every file you expect to change, grouped by layer:

  • desktop service / IPC / shared types
  • iOS RemoteModels / SyncService / Database
  • tests on both sides

Prefer additive, backwards-compatible payload changes unless the feature specifically requires replacement.

3. Write tests first (red)

Add or update the smallest targeted tests first:

  • desktop Vitest tests for the service, mapper, or payload generator
  • iOS ADETests.swift coverage for decoding, filtering, caching, or navigation-request logic

The new or changed tests should fail before implementation.

4. Implement the contract change (green)

Implement across all required layers:

  • extend the desktop payload/service with the required data or action
  • keep payloads explicit and stable for iOS decoding
  • update RemoteModels.swift and SyncService.swift to match exactly
  • update Database.swift projections/caching only when the feature needs offline or cached behavior
  • make the minimum compile fixes in any dependent UI files, but leave major UI follow-up to the iOS worker
Show full SKILL.md (242 more words)Show less
5. Preserve offline and capability behavior

Parity work must not break cached reading or offline gating.

  • if the feature is live-only, expose that state explicitly so iOS can disable or message it cleanly
  • if the feature should stay visible while offline, ensure the cached projection still hydrates
  • if actions are capability-gated, preserve explicit capability checks instead of silent no-ops
6. Verify both stacks

Run the relevant desktop and iOS checks:

bash
npm --prefix apps/desktop run typecheck
npm --prefix apps/desktop run test -- --maxWorkers=7
npm --prefix apps/desktop run build

xcodebuild build -project apps/ios/ADE.xcodeproj -scheme ADE -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=26.3.1' -quiet
xcodebuild test -project apps/ios/ADE.xcodeproj -scheme ADE -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=26.3.1' -quiet

If the feature only touches a narrow desktop surface, run the tightest relevant test subset first, then finish with the broader required checks.

7. Manual verification

Before handing off:

  • prove the payload shape matches on both sides
  • verify any new iOS gating/offline behavior is intentional
  • confirm the consuming UI has enough data to complete the parity feature
  • if practical, launch the desktop host and confirm the new data/action is observable from the iOS app or simulator path
8. Commit

Commit with a message describing the parity contract or sync-host extension that was added.

Example handoff

json
{
  "salientSummary": "Extended the desktop PR snapshot payload with ordered stack members and explicit live-action capability flags, then wired the new fields through RemoteModels/SyncService and iOS tests. Desktop and iOS validations passed, and the PRs tab now has the data needed for mobile stack visibility and clean offline gating.",
  "whatWasImplemented": "Added stack-member and capability metadata to the desktop PR hydration path, updated shared typings and the iOS RemoteModels decoder, taught SyncService to persist the new snapshot fields, and added targeted desktop/iOS tests covering snapshot generation and decoding. The UI was only touched enough to compile against the new payload shape; the remaining PR presentation work stays with the iOS worker.",
  "whatWasLeftUndone": "",
  "verification": {
    "commandsRun": [
      {
        "command": "npm --prefix apps/desktop run typecheck",
        "exitCode": 0,
        "observation": "Desktop TypeScript contracts compile cleanly"
      },
      {
        "command": "npm --prefix apps/desktop run test -- --maxWorkers=7",
        "exitCode": 0,
        "observation": "Desktop Vitest suite passed with the new PR payload coverage"
      },
      {
        "command": "xcodebuild test -project apps/ios/ADE.xcodeproj -scheme ADE -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=26.3.1' -quiet",
        "exitCode": 0,
        "observation": "iOS tests passed with new decoding/caching assertions"
      }
    ],
    "interactiveChecks": [
      {
        "action": "Compared the desktop snapshot payload shape against RemoteModels and SyncService usage",
        "observed": "All new fields decode and persist cleanly; no silent capability fallthrough remains"
      }
    ]
  },
  "tests": {
    "added": [
      {
        "file": "apps/desktop/src/main/services/prs/prService.test.ts",
        "cases": [
          {
            "name": "includes ordered stack members in mobile PR snapshot",
            "verifies": "The desktop host emits stack-member metadata expected by the mobile PR surface"
          }
        ]
      },
      {
        "file": "apps/ios/ADETests/ADETests.swift",
        "cases": [
          {
            "name": "testPullRequestSnapshotDecodesStackMembersAndCapabilities",
            "verifies": "The iOS model and SyncService can decode the new PR snapshot fields"
          }
        ]
      }
    ]
  },
  "discoveredIssues": []
}

When to Return to Orchestrator

  • The requested parity behavior would require a new product scope beyond the current mission (for example dedicated CTO or Missions surfaces)
  • The change would require a risky contract break instead of an additive extension
  • Desktop or iOS tests fail in unrelated areas and cannot be repaired safely inside the feature boundary
  • The feature needs UI redesign beyond minor compile-fix wiring; hand it back to the iOS worker after the contract change lands

© arul28, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .factory/skills/sync-parity-worker of arul28/ADE.

Open the folder on GitHubat commit fbbd974

Compare with similar skills

Sync Parity Worker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sync Parity Worker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Parity Worker this skillarul28/ADE114—~1.8kAutomated safety check: PassAGPL-3.0
Hig Project Contextraintree-technology/hig-doctor1435 repos~1.2kAutomated safety check: PassMIT
Hig Components Contentraintree-technology/hig-doctor1435 repos~1.3kAutomated safety check: PassMIT
iOS Simulator Skilln0an/VivaDicta1311 repos~2.5kAutomated safety check: PassMIT
Inspector Implementationipedro/Inspector170—~729Automated safety check: PassMIT
Run iOS SimulatoriPlug2/iPlug2OOS158—~711Automated safety check: PassNone

Similar skills

  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    143 GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    143 GitHub starsUsed in 5 repos~1.3k tokens
    MobileAuto-check passed
  • iOS Simulator Skill

    n0an/VivaDicta

    21 production-ready scripts for iOS app testing, building, and automation.

    131 GitHub starsUsed in 1 repo~2.5k tokens
    MobileAuto-check passed
  • Inspector Implementation

    ipedro/Inspector

    A skill your agent uses when an agent needs to implement or modify the Inspector library itself — panel UI, hierarchy/runtime behavior, custom property models, macros, or Example-app dogfooding.

    170 GitHub stars~729 tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Run iOS Simulator

    iPlug2/iPlug2OOS

    Build and run an iPlug2 iOS app in the iOS Simulator. An agent skill from iPlug2/iPlug2OOS.

    158 GitHub stars~711 tokensUpdated 23 days ago
    MobileAuto-check passed
  • Official

    Evaluates a bitwarden/ios "Update SDK to" PR against the sdk-swift commit range for compile-time, runtime and serialization breaking changes, maps affected symbols to iOS call sites, and applies…

    695 GitHub stars~2.6k tokensUpdated today
    MobileAuto-check passed

More from arul28/ADE

All 28 skills in this repo
  • Ade App Control

    arul28/ADE

    A skill your agent uses when you need to run or drive a local Electron/desktop app and capture what it does — launch it or attach to a running renderer, read its logs or answer its terminal prompts…

    114 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Iteratively optimize an ADE tab's CPU/memory/IPC/render performance.

    114 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Ade Browser

    arul28/ADE

    A skill your agent uses for any browser behavior at all — opening a URL, checking a localhost page, clicking or filling a form, logging in, screenshotting, inspecting the DOM, or verifying a page…

    114 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Ade Deeplinks

    arul28/ADE

    A skill your agent uses when an agent needs to mint, share, or open ADE deeplinks (lane, work session, file, commit, artifact, branch, PR, Linear issue) so users — or the agent itself — can jump…

    114 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Ade Harnesses

    arul28/ADE

    A skill your agent uses when you need to run a chat, a CLI session, or a subagent on a specific setup — any model you pay for inside any harness (e.g.

    114 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Ade Lanes Git

    arul28/ADE

    A skill your agent uses when creating, inspecting, syncing, committing, pushing, archiving, or rebasing ADE lanes and lane worktrees through ade lanes and ade git.

    114 GitHub stars~594 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Sync Parity Worker

What does Sync Parity Worker do?

Extends ADE desktop sync contracts, shared payloads, and iOS models/services when tab parity requires backend work. Sync Parity Worker is an agent skill from arul28/ADE.

When should I use Sync Parity Worker?

Sync Parity Worker fits situations like: tasks that involve iOS development.

How do I install Sync Parity Worker in Claude Code?

Run `npx skills add arul28/ADE --skill sync-parity-worker -a claude-code`. Or copy the skill folder (.factory/skills/sync-parity-worker in arul28/ADE) into .claude/skills/sync-parity-worker in your project. Claude Code loads it when a task matches its description.

How do I install Sync Parity Worker in Codex?

Run `npx skills add arul28/ADE --skill sync-parity-worker -a codex`. Or copy the skill folder (.factory/skills/sync-parity-worker in arul28/ADE) into .agents/skills/sync-parity-worker in your project. Codex loads it when a task matches its description.

Can I use Sync Parity Worker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add arul28/ADE --skill sync-parity-worker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sync-parity-worker, .gemini/skills/sync-parity-worker, .github/skills/sync-parity-worker and .opencode/skills/sync-parity-worker in your project.

What does Sync Parity Worker need to run?

Going by SKILL.md and its folder, Sync Parity Worker needs the command-line tools its instructions call (npm and xcodebuild).

Does Sync Parity Worker access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sync Parity Worker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sync Parity Worker use?

Sync Parity Worker is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sync Parity Worker use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sync Parity Worker?

Skills that share tags, products or a category with Sync Parity Worker: Hig Project Context (raintree-technology/hig-doctor, 143 stars), Hig Components Content (raintree-technology/hig-doctor, 143 stars), iOS Simulator Skill (n0an/VivaDicta, 131 stars) and Inspector Implementation (ipedro/Inspector, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Parity Worker?

arul28 (a GitHub user) maintains it in arul28/ADE, which has 114 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 8, 2026.

Source: arul28/ADE on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.