@vikasagarwal101/skill-sync 1.0.0

package/lib/authoring.sh

@@ -0,0 +1,200 @@
+cmd_create() {
+    local name="$1"
+    shift || true
+    local scope="agents"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --scope) scope="$2"; shift 2 ;;
+            --to)
+                local to_target="$2"; shift 2
+                ;;
+            *) shift ;;
+        esac
+    done
+
+    # Validate scope
+    [ -z "${SOURCES[$scope]:-}" ] && {
+        echo "Unknown scope '$scope'. Use: agents, opencode, codex"
+        return 1
+    }
+
+    local dir="${SOURCES[$scope]}/$name"
+    [ -d "$dir" ] && {
+        echo "'$name' already exists at $dir"
+        return 1
+    }
+
+    mkdir -p "$dir"
+    cat > "$dir/SKILL.md" << EOF
+---
+name: $name
+description: TODO — describe what this skill does and when to trigger it. Include specific use cases and example phrases the user might say.
+---
+
+# $(echo "$name" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++)$i=toupper(substr($i,1,1))substr($i,2)}1')
+
+## When to Use
+
+TODO — Describe the specific scenarios where this skill should be triggered.
+
+## Workflow
+
+TODO — Describe the step-by-step process.
+
+## Key Rules
+
+TODO — List any non-negotiable rules or constraints.
+EOF
+
+    manifest_add "$name" "$scope" "-"
+    echo "✅ Created '$name' in $scope"
+    echo "   $dir/SKILL.md"
+    echo ""
+    echo "   Edit the SKILL.md, then deploy with:"
+    echo "   skill-sync add $name --to claude"
+}
+
+cmd_edit() {
+    local name="$1"
+    local src_path
+    src_path=$(source_path_for_skill "$name") || {
+        echo "'$name' not found in any canonical source"
+        return 1
+    }
+
+    local skill_md="$src_path/SKILL.md"
+    [ -f "$skill_md" ] || {
+        echo "No SKILL.md at $src_path"
+        return 1
+    }
+
+    local editor="${EDITOR:-vi}"
+    echo "Opening $skill_md with $editor..."
+    "$editor" "$skill_md"
+
+    # After editor exits, offer to sync if skill has targets
+    local targets
+    targets=$(manifest_get_field "$name" "targets" 2>/dev/null)
+    if [ -n "$targets" ] && [ "$targets" != "-" ]; then
+        echo ""
+        echo "Skill '$name' has targets: $targets"
+        echo "Run 'skill-sync sync $name' to push changes."
+    fi
+}
+
+cmd_pull() {
+    local name="$1"
+    shift || true
+    local from_target=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --from) from_target="$2"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    local src_path
+    src_path=$(source_path_for_skill "$name") || {
+        echo "Canonical source for '$name' not found"
+        return 1
+    }
+
+    # Find which target to pull from
+    local tlabel tdir
+    if [ -n "$from_target" ]; then
+        tlabel="$from_target"
+        tdir="${TARGETS[$tlabel]:-}"
+        [ -z "$tdir" ] && { echo "Unknown target '$tlabel'"; return 1; }
+    else
+        # Auto-detect: find first target that has this skill
+        for tl in "${!TARGETS[@]}"; do
+            if [ -d "${TARGETS[$tl]}/$name" ]; then
+                tlabel="$tl"
+                tdir="${TARGETS[$tl]}"
+                break
+            fi
+        done
+    fi
+
+    [ -z "${tlabel:-}" ] && { echo "'$name' not found in any target"; return 1; }
+
+    if [ ! -d "$tdir/$name" ]; then
+        echo "'$name' not in $tlabel"
+        return 1
+    fi
+
+    local src_hash tgt_hash
+    src_hash=$(md5_content "$src_path")
+    tgt_hash=$(md5_content "$tdir/$name")
+
+    if [ "$src_hash" = "$tgt_hash" ]; then
+        echo "✅ Already in sync — no changes to pull"
+        return 0
+    fi
+
+    echo "Pulling '$name' from $tlabel → canonical source..."
+    _safe_rm "$src_path"
+    _safe_cp "$tdir/$name" "$src_path"
+    echo "✅ Pulled. Canonical source updated from $tlabel copy."
+    echo "   Run 'skill-sync sync' to push to other targets."
+}
+
+cmd_rename() {
+    local old_name="$1"
+    local new_name="$2"
+
+    [ -z "$new_name" ] && { echo "Usage: skill-sync rename <old> <new>"; return 1; }
+
+    # Validate new name
+    [[ "$new_name" =~ ^[a-z0-9][-a-z0-9/]*$ ]] || {
+        echo "Invalid name '$new_name' — use lowercase, hyphens, digits only"
+        return 1
+    }
+
+    local src_label src_path
+    src_label=$(source_for_skill "$old_name" 2>/dev/null) || {
+        echo "'$old_name' not found in any source"
+        return 1
+    }
+    src_path=$(source_path_for_skill "$old_name")
+
+    # Check new name doesn't already exist
+    if source_for_skill "$new_name" >/dev/null 2>&1; then
+        echo "'$new_name' already exists"
+        return 1
+    fi
+
+    echo "Renaming: $old_name → $new_name"
+    echo ""
+
+    # 1. Rename canonical source
+    local src_parent
+    src_parent=$(dirname "$src_path")
+    _safe_mv "$src_path" "$src_parent/$new_name"
+    echo "  📝 Renamed in $src_label source"
+
+    # 2. Rename in all targets
+    for tlabel in "${!TARGETS[@]}"; do
+        local tdir="${TARGETS[$tlabel]}"
+        if [ -d "$tdir/$old_name" ]; then
+            _safe_rm "$tdir/$old_name"
+            _safe_cp "$src_parent/$new_name" "$tdir/$new_name"
+            echo "  🔄 Updated in $tlabel"
+        fi
+    done
+
+    # 3. Update manifest
+    manifest_remove "$old_name"
+    local targets="-"
+    for tlabel in "${!TARGETS[@]}"; do
+        if [ -d "${TARGETS[$tlabel]}/$new_name" ]; then
+            [ "$targets" = "-" ] && targets="$tlabel" || targets="$targets,$tlabel"
+        fi
+    done
+    manifest_add "$new_name" "$src_label" "$targets"
+
+    echo ""
+    echo "✅ Renamed $old_name → $new_name across all locations"
+}

package/lib/core.sh

@@ -0,0 +1,221 @@
+# -- Configuration --
+
+CONFIG_DIR="${SKILLSYNC_CONFIG_DIR:-$HOME/.config/skill-sync}"
+MANIFEST="$CONFIG_DIR/manifest"
+CONFIG_FILE="$CONFIG_DIR/config"
+
+# Defaults (overridden by config file if present)
+declare -A SOURCES=(
+    [agents]="${SKILLSYNC_AGENTS_DIR:-$HOME/.agents/skills}"
+    [opencode]="${SKILLSYNC_OPENCODE_DIR:-$HOME/.config/opencode/skills}"
+    [codex]="${SKILLSYNC_CODEX_DIR:-$HOME/.codex/skills}"
+)
+
+declare -A TARGETS=(
+    [claude]="${SKILLSYNC_CLAUDE_DIR:-$HOME/.claude/skills}"
+)
+
+SOURCE_PRIORITY=("agents" "opencode" "codex")
+
+# Load config file if it exists (overrides defaults)
+[ -f "$CONFIG_FILE" ] && source "$CONFIG_FILE"
+
+# Global flags
+DRY_RUN=0
+
+# -- Helpers --
+
+# Safe operations that respect --dry-run
+_safe_cp() { [ $DRY_RUN -eq 1 ] && echo "  [dry-run] cp -r $1 $2" || cp -r "$1" "$2"; }
+_safe_rm() { [ $DRY_RUN -eq 1 ] && echo "  [dry-run] rm -rf $1" || rm -rf "$1"; }
+_safe_mv() { [ $DRY_RUN -eq 1 ] && echo "  [dry-run] mv $1 $2" || mv "$1" "$2"; }
+
+md5_content() {
+    find "$1" -type f -exec md5sum {} \; 2>/dev/null | awk '{print $1}' | sort | md5sum | cut -d' ' -f1
+}
+
+dir_exists() { [ -d "$1" ]; }
+
+source_for_skill() {
+    local name="$1"
+    for label in "${SOURCE_PRIORITY[@]}"; do
+        local dir="${SOURCES[$label]}"
+        if [ -f "$dir/$name/SKILL.md" ] || [ -d "$dir/$name" ]; then
+            echo "$label"
+            return 0
+        fi
+    done
+    return 1
+}
+
+source_path_for_skill() {
+    local name="$1"
+    for label in "${SOURCE_PRIORITY[@]}"; do
+        local dir="${SOURCES[$label]}"
+        if [ -f "$dir/$name/SKILL.md" ] || [ -d "$dir/$name" ]; then
+            echo "$dir/$name"
+            return 0
+        fi
+    done
+    return 1
+}
+
+all_skill_names() {
+    declare -A seen
+    for label in "${SOURCE_PRIORITY[@]}"; do
+        local dir="${SOURCES[$label]}"
+        dir_exists "$dir" || continue
+        for d in "$dir"/*/; do
+            [ -d "$d" ] || continue
+            local n
+            n=$(basename "$d")
+            [ "$n" = ".system" ] && continue
+            if [ -f "$d/SKILL.md" ]; then
+                [ -n "${seen[$n]:-}" ] && continue
+                seen[$n]=1
+                echo "$n"
+            else
+                for sub in "$d"*/; do
+                    [ -d "$sub" ] || continue
+                    [ -f "$sub/SKILL.md" ] || continue
+                    local sn nested
+                    sn=$(basename "$sub")
+                    nested="$n/$sn"
+                    [ -n "${seen[$nested]:-}" ] && continue
+                    seen[$nested]=1
+                    echo "$nested"
+                done
+            fi
+        done
+    done
+    for label in "${!TARGETS[@]}"; do
+        local dir="${TARGETS[$label]}"
+        dir_exists "$dir" || continue
+        for d in "$dir"/*/; do
+            [ -d "$d" ] || continue
+            local n
+            n=$(basename "$d")
+            if [ -f "$d/SKILL.md" ]; then
+                [ -n "${seen[$n]:-}" ] && continue
+                seen[$n]=1
+                echo "$n"
+            else
+                for sub in "$d"*/; do
+                    [ -d "$sub" ] || continue
+                    [ -f "$sub/SKILL.md" ] || continue
+                    local sn nested
+                    sn=$(basename "$sub")
+                    nested="$n/$sn"
+                    [ -n "${seen[$nested]:-}" ] && continue
+                    seen[$nested]=1
+                    echo "$nested"
+                done
+            fi
+        done
+    done
+}
+
+extract_frontmatter_field() {
+    local file="$1"
+    local field="$2"
+    [ -f "$file" ] || return 1
+    awk -v field="$field" '
+        BEGIN { found=0; block=""; is_block=0 }
+        /^---$/ {
+            if (found && is_block) { print block; exit }
+            in_fm = !in_fm; next
+        }
+        in_fm && !found && $0 ~ "^"field":" {
+            val = $0
+            sub("^"field":\\s*", "", val)
+            if (val == ">" || val == ">-" || val == "|" || val == "|-") {
+                is_block = 1; found = 1; next
+            }
+            gsub(/^["'\'']|["'\'']$/, "", val)
+            if (val == ">") val = ""
+            print val
+            exit
+        }
+        found && is_block && /^[ \t]/ {
+            line = $0; sub(/^[ \t]+/, "", line)
+            if (block == "") block = line
+            else block = block " " line
+            next
+        }
+        found && is_block && /^[^ \t]/ { print block; exit }
+        END { if (found && is_block) print block }
+    ' "$file"
+}
+
+has_frontmatter() {
+    local file="$1"
+    [ -f "$file" ] || return 1
+    head -1 "$file" 2>/dev/null | grep -q '^---$'
+}
+
+# -- Manifest --
+
+ensure_manifest() {
+    mkdir -p "$CONFIG_DIR"
+    if [ ! -f "$MANIFEST" ]; then
+        cmd_init
+    fi
+}
+
+manifest_get_field() {
+    local name="$1" field="$2"
+    [ -f "$MANIFEST" ] || return 1
+    awk -F'|' -v name="$name" -v field="$field" '
+        NR <= 4 { next }
+        { gsub(/[ \t]+/, "", $1); gsub(/[ \t]+/, "", $2); gsub(/[ \t]+/, "", $3) }
+        $1 == name {
+            if (field == "source") print $2
+            else if (field == "targets") print $3
+            exit
+        }
+    ' "$MANIFEST"
+}
+
+manifest_has() {
+    local name="$1"
+    [ -f "$MANIFEST" ] || return 1
+    awk -F'|' -v name="$name" '
+        NR <= 4 { next }
+        { gsub(/[ \t]+/, "", $1) }
+        $1 == name { found=1; exit }
+        END { exit !found }
+    ' "$MANIFEST"
+}
+
+manifest_add() {
+    local name="$1" source="$2" targets="$3"
+    ensure_manifest
+    if manifest_has "$name"; then
+        local tmp
+        tmp=$(mktemp)
+        awk -F'|' -v name="$name" -v src="$source" -v tgt="$targets" '
+            NR <= 4 { print; next }
+            { gsub(/[ \t]+/, "", $1) }
+            $1 == name { printf "%-30s | %-10s | %s\n", name, src, tgt; next }
+            { print }
+        ' "$MANIFEST" > "$tmp"
+        mv "$tmp" "$MANIFEST"
+    else
+        printf "%-30s | %-10s | %s\n" "$name" "$source" "$targets" >> "$MANIFEST"
+    fi
+}
+
+manifest_remove() {
+    local name="$1"
+    [ -f "$MANIFEST" ] || return 0
+    local tmp
+    tmp=$(mktemp)
+    awk -F'|' -v name="$name" '
+        NR <= 4 { print; next }
+        { gsub(/[ \t]+/, "", $1) }
+        $1 != name { print }
+    ' "$MANIFEST" > "$tmp"
+    mv "$tmp" "$MANIFEST"
+}
+
+

package/lib/health.sh

@@ -0,0 +1,136 @@
+cmd_validate() {
+    local name="${1:-}"
+    local errors=0
+
+    if [ -n "$name" ]; then
+        local src_path
+        src_path=$(source_path_for_skill "$name" 2>/dev/null) || {
+            echo "❌ '$name' not found"
+            return 1
+        }
+        _validate_skill "$name" "$src_path"
+        return $?
+    fi
+
+    # Validate all
+    for n in $(all_skill_names | sort); do
+        local sp
+        sp=$(source_path_for_skill "$n" 2>/dev/null) || continue
+        _validate_skill "$n" "$sp" || errors=$((errors + 1))
+    done
+    echo ""
+    [ $errors -eq 0 ] && echo "All skills valid ✅" || echo "$errors skills have issues"
+}
+
+_validate_skill() {
+    local name="$1" path="$2"
+    local file="$path/SKILL.md"
+    local ok=1
+
+    [ -f "$file" ] || { echo "❌ $name — no SKILL.md"; return 1; }
+
+    has_frontmatter "$file" || { echo "❌ $name — missing YAML frontmatter (---)"; return 1; }
+
+    local fm_name fm_desc
+    fm_name=$(extract_frontmatter_field "$file" "name")
+    fm_desc=$(extract_frontmatter_field "$file" "description")
+
+    [ -z "$fm_name" ] && { echo "❌ $name — missing 'name' in frontmatter"; ok=0; }
+    [ -z "$fm_desc" ] && { echo "❌ $name — missing 'description' in frontmatter"; ok=0; }
+
+    # Check naming: lowercase, hyphens, digits only
+    [[ "$name" =~ ^[a-z0-9][-a-z0-9/]*$ ]] || { echo "⚠️  $name — name should be lowercase-hyphenated"; ok=0; }
+
+    # Check description length
+    if [ -n "$fm_desc" ]; then
+        local dlen=${#fm_desc}
+        [ $dlen -lt 20 ] && { echo "⚠️  $name — description very short ($dlen chars)"; ok=0; }
+    fi
+
+    [ $ok -eq 1 ] && echo "✅ $name"
+    return $(( 1 - ok ))
+}
+
+cmd_doctor() {
+    echo "Skill system health check"
+    echo ""
+    local issues=0
+
+    echo "── Frontmatter & naming ──"
+    cmd_validate || issues=$((issues + 1))
+
+    echo ""
+    echo "── Orphaned copies (in targets but no source) ──"
+    for tlabel in "${!TARGETS[@]}"; do
+        local tdir="${TARGETS[$tlabel]}"
+        dir_exists "$tdir" || continue
+        for d in "$tdir"/*/; do
+            [ -d "$d" ] || continue
+            local n
+            n=$(basename "$d")
+            if [ -f "$d/SKILL.md" ]; then
+                if ! source_for_skill "$n" >/dev/null 2>&1; then
+                    echo "  ⚠️  $n — in $tlabel but no canonical source"
+                    issues=$((issues + 1))
+                fi
+            else
+                for sub in "$d"*/; do
+                    [ -d "$sub" ] || continue
+                    [ -f "$sub/SKILL.md" ] || continue
+                    local sn nested
+                    sn=$(basename "$sub")
+                    nested="$n/$sn"
+                    if ! source_for_skill "$nested" >/dev/null 2>&1; then
+                        echo "  ⚠️  $nested — in $tlabel but no canonical source"
+                        issues=$((issues + 1))
+                    fi
+                done
+            fi
+        done
+    done
+    [ $issues -eq 0 ] && echo "  None ✅"
+
+    echo ""
+    echo "── Sync drift ──"
+    local drift=0
+    for tlabel in "${!TARGETS[@]}"; do
+        local tdir="${TARGETS[$tlabel]}"
+        dir_exists "$tdir" || continue
+        for d in "$tdir"/*/; do
+            [ -d "$d" ] || continue
+            local n
+            n=$(basename "$d")
+            local src_path
+            src_path=$(source_path_for_skill "$n" 2>/dev/null) || continue
+            if [ "$(md5_content "$src_path")" != "$(md5_content "$d")" ]; then
+                echo "  🔄 $n — drifted in $tlabel"
+                drift=$((drift + 1))
+            fi
+        done
+    done
+    [ $drift -eq 0 ] && echo "  All in sync ✅"
+
+    echo ""
+    echo "── Location summary ──"
+    for label in "${SOURCE_PRIORITY[@]}"; do
+        local dir="${SOURCES[$label]}"
+        if dir_exists "$dir"; then
+            local count
+            count=$(find "$dir" -maxdepth 1 -mindepth 1 -type d ! -name ".system" | wc -l)
+            printf "  %-12s %2d skills  %s\n" "$label" "$count" "$dir"
+        fi
+    done
+    for tlabel in "${!TARGETS[@]}"; do
+        local tdir="${TARGETS[$tlabel]}"
+        if dir_exists "$tdir"; then
+            local count
+            count=$(find "$tdir" -maxdepth 1 -mindepth 1 -type d | wc -l)
+            printf "  %-12s %2d skills  %s\n" "$tlabel" "$count" "$tdir"
+        fi
+    done
+
+    echo ""
+    local total_issues=$((issues + drift))
+    [ $total_issues -eq 0 ] && echo "All healthy ✅" || echo "$total_issues total issues found"
+}
+