# Sync Skill Repo

> Hidden compatibility backend for publishing explicitly selected shared skills. Invoke explicitly for legacy sync commands or deterministic batch validation, testing, exact-path commit and push, named Skills CLI updates, and installation/lock verification. Project-private skills are rejected.

- Skill: `hu-wentao/sync-skill-repo` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add hu-wentao/sync-skill-repo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hu-wentao/sync-skill-repo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Hu-Wentao (https://skillmd.com/u/hu-wentao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hu-wentao/sync-skill-repo

---


# Sync Skill Repo Backend

Use `skillcraft` for ownership and revision decisions. This hidden skill preserves explicit compatibility and owns only deterministic publication mechanics.

## Canonical batch command

```bash
uv run python <skill-root>/scripts/sync_skill_repo.py publish-batch \
  --repo <source-repository> \
  --skill <name> [--skill <name> ...] \
  [--include-path <explicit-path>] \
  [--project-root <consumer-project>] \
  [--expected-upstream-head <sha> --expected-source-head <sha>]
```

The runner validates budgets and references, runs each `scripts/tests/run.py`, stages only explicit paths, creates at most one commit, pushes once, runs `pnpm dlx skills update <name> -y` once per name from a neutral cwd, verifies matching installations and locks, and emits `sync-skill-repo.publish-receipt.v2` JSON.

Existing ahead commits require both exact head arguments. Input under `package/node_modules`, project-private source, `skills-config`, ambiguous locks, unrelated dirty paths, non-GitHub upstreams, stale heads, or missing update locks fails closed. A push followed by update failure returns `completed: false`.

## Compatibility commands

- `register <repo>`: register a local shared source checkout.
- `publish <skill-dir>`: one-skill compatibility publication.
- `sync <skill-dir>`: copy a valid lock-managed skill to registered source.
- `refresh` and `install`: explicit recovery/first-install compatibility operations.

Do not use compatibility commands to bypass `skillcraft` ownership classification.

## Resource

- `scripts/sync_skill_repo.py`: canonical publisher and compatibility backend.
- `scripts/tests/run.py`: complete backend test entry point.