@vikasagarwal101/skill-sync 1.0.0

package/lib/inspect.sh

@@ -0,0 +1,210 @@
+cmd_info() {
+    local name="$1"
+
+    local src_label
+    src_label=$(source_for_skill "$name" 2>/dev/null) || {
+        echo "'$name' not found in any canonical source"
+        # Check if it's orphaned in a target
+        for tlabel in "${!TARGETS[@]}"; do
+            if [ -d "${TARGETS[$tlabel]}/$name" ]; then
+                echo "  ⚠️  Found orphaned copy in $tlabel (no canonical source)"
+            fi
+        done
+        return 1
+    }
+
+    local src_path
+    src_path=$(source_path_for_skill "$name")
+    local desc
+    desc=$(extract_frontmatter_field "$src_path/SKILL.md" "description")
+    [ -z "$desc" ] && desc="(no description)"
+
+    echo "$name"
+    echo "  Source:     $src_label ($src_path)"
+    echo "  Description: $desc"
+
+    # Size and files
+    local size files
+    size=$(du -sh "$src_path" 2>/dev/null | cut -f1)
+    files=$(find "$src_path" -type f | wc -l)
+    echo "  Files:      $files ($size)"
+
+    # Frontmatter health
+    if has_frontmatter "$src_path/SKILL.md"; then
+        echo "  Frontmatter: ✅ present"
+    else
+        echo "  Frontmatter: ❌ MISSING"
+    fi
+
+    # Targets / sync state
+    local manifest_targets="-"
+    [ -f "$MANIFEST" ] && manifest_targets=$(manifest_get_field "$name" "targets")
+    [ -z "$manifest_targets" ] && manifest_targets="(not in manifest)"
+    echo "  Manifest:   $manifest_targets"
+
+    echo "  Copies:"
+    for tlabel in "${!TARGETS[@]}"; do
+        local tdir="${TARGETS[$tlabel]}"
+        if [ -d "$tdir/$name" ]; then
+            local sh th
+            sh=$(md5_content "$src_path")
+            th=$(md5_content "$tdir/$name")
+            if [ "$sh" = "$th" ]; then
+                echo "    $tlabel: ✅ in sync"
+            else
+                echo "    $tlabel: 🔄 DRIFTED"
+            fi
+        else
+            echo "    $tlabel: — (not deployed)"
+        fi
+    done
+}
+
+cmd_status() {
+    ensure_manifest
+    printf "%-30s %-10s %-15s %s\n" "SKILL" "SOURCE" "TARGETS" "STATE"
+    printf "%-30s %-10s %-15s %s\n" "$(printf '%.0s-' {1..30})" "$(printf '%.0s-' {1..10})" "$(printf '%.0s-' {1..15})" "$(printf '%.0s-' {1..5})"
+
+    local all_ok=1
+
+    while IFS='|' read -r name source targets; do
+        name=$(echo "$name" | xargs)
+        [[ "$name" =~ ^# ]] && continue
+        [ -z "$name" ] && continue
+        source=$(echo "$source" | xargs)
+        targets=$(echo "$targets" | xargs)
+
+        local state=""
+        if [ "$targets" = "-" ]; then
+            state="canonical"
+        else
+            IFS=',' read -ra tgt_arr <<< "$targets"
+            for tlabel in "${tgt_arr[@]}"; do
+                tlabel=$(echo "$tlabel" | xargs)
+                local tdir="${TARGETS[$tlabel]}"
+                local src_path
+                src_path=$(source_path_for_skill "$name" 2>/dev/null)
+                if [ -z "$src_path" ]; then
+                    state="$state ⚠️"
+                    all_ok=0
+                elif [ -d "$tdir/$name" ]; then
+                    if [ "$(md5_content "$src_path")" = "$(md5_content "$tdir/$name")" ]; then
+                        state="$state ✅"
+                    else
+                        state="$state 🔄"
+                        all_ok=0
+                    fi
+                else
+                    state="$state ❌"
+                    all_ok=0
+                fi
+            done
+        fi
+
+        printf "%-30s %-10s %-15s %s\n" "$name" "$source" "$targets" "$state"
+    done < "$MANIFEST"
+
+    echo ""
+    [ $all_ok -eq 1 ] && echo "All synced ✅" || echo "Issues found — run 'skill-sync sync' to fix"
+}
+
+cmd_list() {
+    local show_all="${1:-}"
+
+    if [ "$show_all" != "--all" ]; then
+        # List manifest skills only
+        ensure_manifest
+        printf "%-30s %-10s %s\n" "SKILL" "SOURCE" "TARGETS"
+        printf "%-30s %-10s %s\n" "-----" "------" "-------"
+        while IFS='|' read -r name source targets; do
+            name=$(echo "$name" | xargs)
+            [[ "$name" =~ ^# ]] && continue
+            [ -z "$name" ] && continue
+            source=$(echo "$source" | xargs)
+            targets=$(echo "$targets" | xargs)
+            [ "$targets" != "-" ] && printf "%-30s %-10s %s\n" "$name" "$source" "$targets"
+        done < "$MANIFEST"
+        return
+    fi
+
+    # List ALL skills from all locations
+    printf "%-30s %-10s %-10s %s\n" "SKILL" "SOURCE" "COPIES" "DESCRIPTION"
+    printf "%-30s %-10s %-10s %s\n" "-----" "------" "------" "-----------"
+
+    for name in $(all_skill_names | sort); do
+        local src_label src_path copies=""
+        src_label=$(source_for_skill "$name" 2>/dev/null) || src_label="orphan"
+        src_path=$(source_path_for_skill "$name" 2>/dev/null) || src_path=""
+
+        for tlabel in "${!TARGETS[@]}"; do
+            [ -d "${TARGETS[$tlabel]}/$name" ] && copies="$copies $tlabel"
+        done
+        [ -z "$copies" ] && copies="-"
+
+        local desc=""
+        if [ -n "$src_path" ] && [ -f "$src_path/SKILL.md" ]; then
+            desc=$(extract_frontmatter_field "$src_path/SKILL.md" "description" 2>/dev/null)
+        fi
+        [ -z "$desc" ] && desc="—"
+
+        printf "%-30s %-10s %-10s %.60s\n" "$name" "$src_label" "$copies" "$desc"
+    done
+}
+
+cmd_search() {
+    local query="$*"
+    [ -z "$query" ] && { echo "Usage: skill-sync search <query>"; return 1; }
+    query=$(echo "$query" | tr '[:upper:]' '[:lower:]')
+
+    printf "%-30s %-10s %.70s\n" "SKILL" "SOURCE" "DESCRIPTION"
+    printf "%-30s %-10s %.70s\n" "-----" "------" "-----------"
+
+    local found=0
+    for name in $(all_skill_names | sort); do
+        local src_path desc lname
+        src_path=$(source_path_for_skill "$name" 2>/dev/null) || continue
+        desc=$(extract_frontmatter_field "$src_path/SKILL.md" "description" 2>/dev/null)
+        [ -z "$desc" ] && desc="—"
+        lname=$(echo "$name $desc" | tr '[:upper:]' '[:lower:]')
+
+        if [[ "$lname" == *"$query"* ]]; then
+            local src_label
+            src_label=$(source_for_skill "$name")
+            printf "%-30s %-10s %.70s\n" "$name" "$src_label" "$desc"
+            found=$((found + 1))
+        fi
+    done
+
+    echo ""
+    [ $found -eq 0 ] && echo "No matches for '$query'" || echo "$found skill(s) found"
+}
+
+cmd_diff() {
+    local name="$1"
+
+    local src_path
+    src_path=$(source_path_for_skill "$name") || {
+        echo "'$name' not found in any source"
+        return 1
+    }
+
+    local has_targets=0
+    for tlabel in "${!TARGETS[@]}"; do
+        if [ -d "${TARGETS[$tlabel]}/$name" ]; then
+            has_targets=1
+            echo "── diff: $name (source → $tlabel) ──"
+            diff -rq "$src_path" "${TARGETS[$tlabel]}/$name" 2>/dev/null || true
+            echo ""
+
+            # Show SKILL.md content diff if different
+            if ! diff -q "$src_path/SKILL.md" "${TARGETS[$tlabel]}/$name/SKILL.md" >/dev/null 2>&1; then
+                echo "── SKILL.md content diff ──"
+                diff -u "${TARGETS[$tlabel]}/$name/SKILL.md" "$src_path/SKILL.md" 2>/dev/null || true
+                echo ""
+            fi
+        fi
+    done
+
+    [ $has_targets -eq 0 ] && echo "'$name' has no target copies to diff against"
+}
+

package/lib/sync.sh

@@ -0,0 +1,281 @@
+cmd_init() {
+    mkdir -p "$CONFIG_DIR"
+    echo "# skill-sync manifest" > "$MANIFEST"
+    echo "# Format: skill_name | source | targets" >> "$MANIFEST"
+    echo "# Sources: agents, opencode, codex | Targets: claude (or - for canonical-only)" >> "$MANIFEST"
+    echo "#" >> "$MANIFEST"
+
+    # Build from current state
+    local added=0
+    for name in $(all_skill_names | sort); do
+        local src
+        src=$(source_for_skill "$name" 2>/dev/null || echo "orphan")
+
+        # Determine targets: which target dirs contain this skill
+        local tgt_list="-"
+        for tlabel in "${!TARGETS[@]}"; do
+            local tdir="${TARGETS[$tlabel]}"
+            if dir_exists "$tdir/$name"; then
+                if [ "$tgt_list" = "-" ]; then
+                    tgt_list="$tlabel"
+                else
+                    tgt_list="$tgt_list,$tlabel"
+                fi
+            fi
+        done
+
+        # Skip codex system skills
+        [ "$src" = "codex" ] && {
+            local cdir="${SOURCES[codex]}"
+            [ -d "$cdir/.system/$name" ] && continue
+        }
+
+        printf "%-30s | %-10s | %s\n" "$name" "$src" "$tgt_list" >> "$MANIFEST"
+        added=$((added + 1))
+    done
+
+    echo "Manifest generated: $MANIFEST"
+    echo "  $added skills indexed"
+}
+
+cmd_sync_all() {
+    ensure_manifest
+    local total=0 synced=0 updated=0 failed=0
+
+    echo "Syncing all manifest skills..."
+    echo ""
+
+    while IFS='|' read -r name source targets; do
+        # Skip comments/headers
+        name=$(echo "$name" | xargs)
+        [[ "$name" =~ ^# ]] && continue
+        [ -z "$name" ] && continue
+        source=$(echo "$source" | xargs)
+        targets=$(echo "$targets" | xargs)
+        [ "$targets" = "-" ] && continue
+
+        total=$((total + 1))
+
+        local src_path
+        src_path=$(source_path_for_skill "$name") || {
+            echo "  ⚠️  $name — source not found"
+            failed=$((failed + 1))
+            continue
+        }
+
+        # Sync to each target
+        IFS=',' read -ra tgt_arr <<< "$targets"
+        for tlabel in "${tgt_arr[@]}"; do
+            tlabel=$(echo "$tlabel" | xargs)
+            local tdir="${TARGETS[$tlabel]}"
+            [ -d "$tdir" ] || mkdir -p "$tdir"
+
+            local src_hash tgt_hash
+            src_hash=$(md5_content "$src_path")
+            if [ -d "$tdir/$name" ]; then
+                tgt_hash=$(md5_content "$tdir/$name")
+            else
+                tgt_hash="none"
+            fi
+
+            if [ "$src_hash" = "$tgt_hash" ]; then
+                echo "  ✅ $name → $tlabel (in sync)"
+                synced=$((synced + 1))
+            else
+                _safe_rm "$tdir/$name"
+                _safe_cp "$src_path" "$tdir/$name"
+                echo "  🔄 $name → $tlabel (updated)"
+                updated=$((updated + 1))
+            fi
+        done
+    done < "$MANIFEST"
+
+    echo ""
+    echo "Done: $total skills, $updated updated, $synced already in sync, $failed failed"
+}
+
+cmd_sync_one() {
+    local name="$1"
+    ensure_manifest
+
+    local targets
+    targets=$(manifest_get_field "$name" "targets")
+    [ -z "$targets" ] && {
+        echo "'$name' not in manifest. Use: skill-sync add $name"
+        return 1
+    }
+    [ "$targets" = "-" ] && {
+        echo "'$name' has no sync targets (canonical-only)."
+        return 0
+    }
+
+    local src_path
+    src_path=$(source_path_for_skill "$name") || {
+        echo "Source not found for '$name'"
+        return 1
+    }
+
+    IFS=',' read -ra tgt_arr <<< "$targets"
+    for tlabel in "${tgt_arr[@]}"; do
+        tlabel=$(echo "$tlabel" | xargs)
+        local tdir="${TARGETS[$tlabel]}"
+        [ -d "$tdir" ] || mkdir -p "$tdir"
+
+        if [ -d "$tdir/$name" ] && [ "$(md5_content "$src_path")" = "$(md5_content "$tdir/$name")" ]; then
+            echo "✅ $name → $tlabel (already in sync)"
+        else
+            _safe_rm "$tdir/$name"
+            _safe_cp "$src_path" "$tdir/$name"
+            echo "🔄 $name → $tlabel (updated)"
+        fi
+    done
+}
+
+cmd_add() {
+    local name="$1"
+    shift || true
+    local to_target="claude"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --to) to_target="$2"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    local src_label
+    src_label=$(source_for_skill "$name" 2>/dev/null) || {
+        echo "Skill '$name' not found in any source:"
+        for l in "${SOURCE_PRIORITY[@]}"; do echo "  ${SOURCES[$l]}/$name/"; done
+        return 1
+    }
+
+    local src_path
+    src_path=$(source_path_for_skill "$name")
+
+    local tdir="${TARGETS[$to_target]}"
+    [ -d "$tdir" ] || mkdir -p "$tdir"
+
+    _safe_rm "$tdir/$name"
+    _safe_cp "$src_path" "$tdir/$name"
+
+    manifest_add "$name" "$src_label" "$to_target"
+    echo "✅ '$name' added → $to_target (from $src_label)"
+}
+
+cmd_remove() {
+    local name="$1"
+    shift || true
+    local from_target="" purge=0
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --from) from_target="$2"; shift 2 ;;
+            --purge) purge=1; shift ;;
+            *) shift ;;
+        esac
+    done
+
+    # Safety: resolve the skill and show where it currently exists
+    local src_label="" src_path=""
+    src_label=$(source_for_skill "$name" 2>/dev/null) && src_path=$(source_path_for_skill "$name")
+
+    echo "Removing: $name"
+    echo ""
+
+    # Show current state
+    if [ -n "$src_path" ]; then
+        echo "  Source: $src_label ($src_path)"
+    else
+        echo "  Source: — (no canonical source)"
+    fi
+
+    local target_hits=""
+    for tlabel in "${!TARGETS[@]}"; do
+        if [ -d "${TARGETS[$tlabel]}/$name" ]; then
+            target_hits="$target_hits $tlabel"
+        fi
+    done
+    if [ -n "$target_hits" ]; then
+        echo "  Targets:$target_hits"
+    else
+        echo "  Targets: — (not deployed)"
+    fi
+    echo ""
+
+    # If skill doesn't exist anywhere
+    if [ -z "$src_path" ] && [ -z "$target_hits" ]; then
+        echo "Skill '$name' not found anywhere."
+        manifest_remove "$name"
+        return 0
+    fi
+
+    # Phase 1: Remove from targets
+    local removed_any=0
+
+    if [ -n "$from_target" ]; then
+        # Remove from specific target only
+        local tdir="${TARGETS[$from_target]:-}"
+        if [ -z "$tdir" ]; then
+            echo "Unknown target '$from_target'"
+            return 1
+        fi
+        if [ -d "$tdir/$name" ]; then
+            _safe_rm "$tdir/$name"
+            echo "  🗑️  Removed from $from_target"
+            removed_any=1
+        else
+            echo "  '$name' was not in $from_target"
+        fi
+
+        # Update manifest: remove this target from the list
+        local current_targets
+        current_targets=$(manifest_get_field "$name" "targets")
+        local new_targets=""
+        IFS=',' read -ra remain <<< "$current_targets"
+        for t in "${remain[@]}"; do
+            t=$(echo "$t" | xargs)
+            [ "$t" = "$from_target" ] && continue
+            if [ -z "$new_targets" ]; then new_targets="$t"; else new_targets="$new_targets,$t"; fi
+        done
+        [ -z "$new_targets" ] && new_targets="-"
+        [ -n "$src_label" ] && manifest_add "$name" "$src_label" "$new_targets"
+    else
+        # Remove from ALL targets
+        for tlabel in "${!TARGETS[@]}"; do
+            local tdir="${TARGETS[$tlabel]}"
+            if [ -d "$tdir/$name" ]; then
+                _safe_rm "$tdir/$name"
+                echo "  🗑️  Removed from $tlabel"
+                removed_any=1
+            fi
+        done
+        [ $removed_any -eq 0 ] && echo "  (was not deployed to any target)"
+
+        # Update manifest: set targets to -
+        [ -n "$src_label" ] && manifest_add "$name" "$src_label" "-"
+    fi
+
+    # Phase 2: Purge from canonical source
+    if [ $purge -eq 1 ]; then
+        if [ -n "$src_path" ] && [ -d "$src_path" ]; then
+            _safe_rm "$src_path"
+            echo "  💀 Purged from $src_label source"
+            manifest_remove "$name"
+        elif [ -z "$src_path" ]; then
+            echo "  (no canonical source to purge)"
+        fi
+    fi
+
+    echo ""
+    echo "Done."
+
+    # Show what remains
+    if [ $purge -eq 0 ] && [ -n "$src_label" ]; then
+        echo "  Skill still exists in source: $src_label"
+        echo "  Re-deploy with: skill-sync add $name"
+    elif [ $purge -eq 1 ]; then
+        echo "  Skill fully removed from all locations."
+    fi
+}
+

package/lib/targets.sh

@@ -0,0 +1,73 @@
+# ── Config file writer ─────────────────────────────────────────
+
+_save_config() {
+    mkdir -p "$CONFIG_DIR"
+    {
+        echo "# Auto-generated by skill-sync."
+        echo "# This file is sourced at startup. Edit manually or use target commands."
+        echo ""
+        declare -p SOURCES
+        declare -p TARGETS
+        declare -p SOURCE_PRIORITY
+    } > "$CONFIG_FILE"
+}
+
+# ── New commands ───────────────────────────────────────────────
+
+cmd_target() {
+    local action="${1:-list}"
+
+    case "$action" in
+        list)
+            echo "Sync targets:"
+            echo ""
+            printf "%-15s %s\n" "LABEL" "PATH"
+            printf "%-15s %s\n" "-----" "----"
+            for tlabel in "${!TARGETS[@]}"; do
+                printf "%-15s %s\n" "$tlabel" "${TARGETS[$tlabel]}"
+            done
+            echo ""
+            echo "Sources:"
+            printf "%-15s %s\n" "LABEL" "PATH"
+            printf "%-15s %s\n" "-----" "----"
+            for slabel in "${SOURCE_PRIORITY[@]}"; do
+                printf "%-15s %s\n" "$slabel" "${SOURCES[$slabel]}"
+            done
+            ;;
+        add)
+            local label="$2" path="$3"
+            [ -z "$label" ] || [ -z "$path" ] && {
+                echo "Usage: skill-sync target add <label> <path>"
+                return 1
+            }
+            # Expand ~ in path
+            path="${path/#\~/$HOME}"
+            [ -n "${TARGETS[$label]:-}" ] && {
+                echo "Target '$label' already exists: ${TARGETS[$label]}"
+                return 1
+            }
+            TARGETS["$label"]="$path"
+            mkdir -p "$path"
+            _save_config
+            echo "✅ Added target '$label' → $path"
+            echo "   Config saved to $CONFIG_FILE"
+            ;;
+        remove)
+            local label="$2"
+            [ -z "$label" ] && { echo "Usage: skill-sync target remove <label>"; return 1; }
+            [ -z "${TARGETS[$label]:-}" ] && {
+                echo "Target '$label' not found"
+                return 1
+            }
+            unset "TARGETS[$label]"
+            _save_config
+            echo "🗑️  Removed target '$label'"
+            echo "   (skill directories untouched, config updated)"
+            ;;
+        *)
+            echo "Usage: skill-sync target [list|add|remove]"
+            return 1
+            ;;
+    esac
+}
+

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@vikasagarwal101/skill-sync",
+  "version": "1.0.0",
+  "description": "Manage AI agent skills across multiple directories",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vikasagarwal101/skill-sync.git"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "skills",
+    "claude",
+    "codex",
+    "opencode",
+    "skill-sync",
+    "agents-md"
+  ],
+  "bin": {
+    "skill-sync": "bin/skill-sync.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "rules/",
+    "skill-sync",
+    "install.sh",
+    "scripts/",
+    "README.md"
+  ],
+  "scripts": {
+    "prepublishOnly": "bash scripts/bundle.sh",
+    "prepack": "bash scripts/bundle.sh"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}