Sync

Name: Sync
Author: ksprashu

ASecurity

Synchronize global agent skill symlinks and bootstrap project-scoped skills on demand. Trigger via /sync.

2 stars
0 votes
0 copies
0 views
Added September 3, 2026

ai-agentspythongobashfrontendperformance

Works with

claude code
cli

Security analysis

A100/100

Pro scans all 4 files and shows the line behind each finding

Scanned October 2, 2026

npx -y skills add ksprashu/agent-skill-forge --skill sync --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Sync?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/ksprashu-sync/badge)](https://www.skillsdirectory.com/skills/ksprashu-sync)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: sync
description: Synchronize global agent skill symlinks and bootstrap project-scoped skills on demand. Trigger via /sync.
disable-model-invocation: true
---

# Sync: Skill Symlink & JIT Project Bootstrapper

Manage symlinks across global agent directories and bootstrap project-scoped domain skills on demand.

---

## 🎯 Goal
Maintain unified skill access across Antigravity, Claude Code, and Gemini CLI without duplicating files.

---

## 📋 Step-by-Step Workflow

1. **Audit Global Symlinks**: Run the audit script to check for broken or missing links:
   ```bash
   python3 scripts/sync_skills.py
   ```
2. **Repair & Synchronize**: Fix broken paths and prune obsolete links:
   ```bash
   python3 scripts/sync_skills.py --prune --fix
   ```
3. **Bootstrap Project-Scoped Skills (JIT)**:
   ```bash
   python3 scripts/sync_skills.py --project . --skills frontend-ui-engineering,performance-optimization
   ```

---

## 💡 Concrete Example

### Bootstrapping Command Output
Without `--fix` the command is a dry run and writes nothing:
```bash
$ python3 scripts/sync_skills.py --project . --skills frontend-ui-engineering,performance-optimization
📦 Bootstrapping skills into project: .
  [WOULD BOOTSTRAP] frontend-ui-engineering (preferred) -> ./.gemini/skills/frontend-ui-engineering  (dry run; re-run with --fix to create it)
  [WOULD BOOTSTRAP] performance-optimization (preferred) -> ./.gemini/skills/performance-optimization  (dry run; re-run with --fix to create it)
```

Add `--fix` to actually create the entries:
```bash
$ python3 scripts/sync_skills.py --project . --skills frontend-ui-engineering,performance-optimization --fix
📦 Bootstrapping skills into project: .
  [BOOTSTRAP] frontend-ui-engineering (preferred) -> ./.gemini/skills/frontend-ui-engineering
    -> Created entry to /path/to/agent-skill-forge/preferred/frontend-ui-engineering
  [BOOTSTRAP] performance-optimization (preferred) -> ./.gemini/skills/performance-optimization
    -> Created entry to /path/to/agent-skill-forge/preferred/performance-optimization
```

---

## 🚫 Hard Constraints

*   **NEVER** install heavy domain-specific skills into global agent directories.
*   **NEVER** create hard copies when symlinks can be used.