Skill Sync

Purpose

Keep a skill in every harness that should load it, without turning global instruction files into catalogs.

Canonical root: C:\Users\Admin\.agents\skills\<name>\.

Workflow

1. Name the source and targets. Default source is ~/.agents/skills/<name>. Default targets come from references/harness-map.md. Add a harness only when that agent actually scans the destination.
   • Done when each destination path is known to exist or is created deliberately.
2. Copy the skill directory, not a snippet. Sync SKILL.md plus references/, scripts/, templates/, and assets/ when present. Do not flatten or rename files.
   • Done when destination file names match the source tree.
3. Verify byte-level identity for the synced set. Compare SKILL.md and referenced files. A description-only stub is a failed sync.
   • Done when source and destination hashes match for every synced file.
4. Confirm loader visibility. Check that the destination is a scanned skills root for that harness. Do not edit AGENTS.md just to list the skill.
   • Done when a fresh session of that harness can resolve the skill by name or trigger.

Rules

• One-way by default: agents → selected harnesses. Reverse-sync only when the operator edited the copy on purpose.
• Sync named skills, not the entire 200+ pack, unless the operator asked for a full mirror.
• Prefer updating an existing destination directory in place over creating a second spelling of the same skill.
• Leave archived or harness-specific skills untouched.

Completion Gate

• Source SKILL.md exists and parses.
• Every requested target has an identical tree for the synced files.
• Broken relative links were not introduced by a partial copy.
• The reply lists source, targets, and file counts or hashes.

Common Failure Modes

• Index duplication: pasting the skill name into multiple AGENTS.md files instead of copying the skill tree.
• Stub sync: copying SKILL.md and omitting references/.
• Wrong root: writing into a home directory the harness does not scan.
• Bidirectional drift: editing both copies independently.