Watch & Sync
Watch mode, frozen installs, and automatic agent syncing
watch#
Watch for skill file changes and auto-sync across all agent directories.
skills watch [dir] [options]
| Option | Description |
|---|---|
-a, --agent <agents...> | Agents to sync to (default: all) |
--debounce <ms> | Debounce delay in milliseconds (default: 500) |
Uses Node.js built-in fs.watch for file monitoring (no additional dependencies). When a .md file changes in the watched directory, it automatically copies the updated file to all target agent directories.
Examples:
# Watch global skills directory, sync to all agents
skills watch
# Watch a custom directory
skills watch ./my-skills
# Watch and sync to specific agents only
skills watch --agent cursor,claude
# Custom debounce
skills watch --debounce 1000
Output:
ποΈ Watch Mode
Watching: /Users/you/.antigravity/skills
Syncing to: cursor, claude, copilot, codex, antigravity, ...
Press Ctrl+C to stop.
β³ 09:15:32 frontend-design changed
β Synced to 5 agent(s)
Development workflow: Edit your skill once, and watch mode keeps all 42 agent directories in sync automatically.
frozen#
Install skills from the lockfile with pinned versions β deterministic installs like npm ci.
skills frozen [options]
| Option | Description |
|---|---|
--verify | Only verify that installed skills match the lockfile |
--strict | Fail immediately on first mismatch |
Modes:
| Mode | Description |
|---|---|
| Default (restore) | Re-clones skills from their recorded sources with pinned versions |
--verify | Checks whether installed skills exist at their canonical paths |
--strict | Aborts on first failure (useful for CI) |
Supported source types:
- β’
githubβ Clones from GitHub with optional commit checkout - β’
private-gitβ Clones from private Git repos with auth - β’
localβ Verifies local source path still exists
Examples:
# Restore all skills from lockfile
skills frozen
# Verify mode β check without modifying
skills frozen --verify
# Strict mode for CI pipelines
skills frozen --verify --strict
Output (verify mode):
βοΈ Frozen Install (verify mode)
Found 73 skill(s) in lockfile.
β frontend-design β verified
β typescript-pro β missing
β react-expert β missing
Summary: 1 succeeded / 72 failed / 73 total
CI/CD Integration: Use
skills frozen --verify --strictin your CI pipeline to ensure all team members have identical skill installations. Exits with code 1 on any mismatch.