# Skill Sync

> Use when installing, copying, or checking local skills across agent harnesses. Treat ~/.agents/skills as the source of truth, sync selected skill directories to the target loader, and verify SKILL.md is discoverable.

- Skill: `netvar1337/skill-sync` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add netvar1337/skill-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/netvar1337/skill-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: netvar1337 (https://skillmd.com/u/netvar1337)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/netvar1337/skill-sync

---

# 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](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.