skill-blast 1.0.0__py3-none-any.whl

skill_blast/__init__.py

@@ -0,0 +1,4 @@
+"""skill-blast: One-click installer for 50 top AI agent skills."""
+
+__version__ = "1.0.0"
+__author__ = "skill-blast contributors"

skill_blast/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m skill_blast"""
+from skill_blast.cli import main
+
+if __name__ == "__main__":
+    main()

skill_blast/agents.py

@@ -0,0 +1,108 @@
+"""
+Cross-platform AI agent definitions.
+Each agent has: display name, skill directory, detection logic.
+"""
+
+import os
+import platform
+import shutil
+from pathlib import Path
+from typing import Callable
+
+HOME = Path.home()
+IS_WINDOWS = platform.system() == "Windows"
+IS_MAC = platform.system() == "Darwin"
+
+
+def _appdata() -> Path:
+    """Windows %APPDATA%, macOS ~/Library/Application Support, else HOME."""
+    if IS_WINDOWS:
+        return Path(os.environ.get("APPDATA", HOME / "AppData" / "Roaming"))
+    if IS_MAC:
+        return HOME / "Library" / "Application Support"
+    return HOME
+
+
+def _has_cmd(*cmds: str) -> bool:
+    return any(shutil.which(c) for c in cmds)
+
+
+def _dir_exists(*paths: Path) -> bool:
+    return any(p.exists() for p in paths)
+
+
+# ── Agent registry ─────────────────────────────────────────────────────────────
+# skills_dir: where skill folders are symlinked/copied for that agent
+# detect: returns True if the agent appears to be installed
+
+AGENTS: dict[str, dict] = {
+    "claude-code": {
+        "name": "Claude Code",
+        "icon": "🤖",
+        "skills_dir": HOME / ".claude" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".claude") or _has_cmd("claude"),
+        "docs": "https://docs.anthropic.com/en/docs/claude-code",
+        "note": "Load via /skills in Claude Code",
+    },
+    "opencode": {
+        "name": "OpenCode",
+        "icon": "⚡",
+        "skills_dir": HOME / ".opencode" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".opencode") or _has_cmd("opencode"),
+        "docs": "https://opencode.ai",
+        "note": "Load via /plugin in OpenCode",
+    },
+    "antigravity": {
+        "name": "Antigravity",
+        "icon": "🚀",
+        "skills_dir": HOME / ".antigravity" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".antigravity") or _has_cmd("antigravity"),
+        "docs": "https://antigravity.dev",
+        "note": "Load via /skills in Antigravity",
+    },
+    "gemini-cli": {
+        "name": "Gemini CLI",
+        "icon": "♊",
+        "skills_dir": HOME / ".gemini" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".gemini") or _has_cmd("gemini", "gemini-cli"),
+        "docs": "https://github.com/google-gemini/gemini-cli",
+        "note": "Skills auto-loaded from ~/.gemini/skills/",
+    },
+    "cursor": {
+        "name": "Cursor",
+        "icon": "🖱️",
+        "skills_dir": HOME / ".cursor" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".cursor") or _has_cmd("cursor"),
+        "docs": "https://cursor.com",
+        "note": "Skills available in Cursor agent mode",
+    },
+    "windsurf": {
+        "name": "Windsurf",
+        "icon": "🏄",
+        "skills_dir": HOME / ".codeium" / "windsurf" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".codeium") or _has_cmd("windsurf"),
+        "docs": "https://codeium.com/windsurf",
+        "note": "Load via Cascade in Windsurf",
+    },
+    "continue": {
+        "name": "Continue.dev",
+        "icon": "🔄",
+        "skills_dir": HOME / ".continue" / "skills",
+        "detect": lambda: _dir_exists(HOME / ".continue") or _has_cmd("continue"),
+        "docs": "https://continue.dev",
+        "note": "Skills available in Continue sidebar",
+    },
+    "aider": {
+        "name": "Aider",
+        "icon": "✏️",
+        "skills_dir": HOME / ".aider" / "skills",
+        "detect": lambda: _has_cmd("aider"),
+        "docs": "https://aider.chat",
+        "note": "Reference skill files in your chat",
+    },
+}
+
+
+def detect_agents() -> dict[str, dict]:
+    """Return agents that appear to be installed on this machine."""
+    return {k: v for k, v in AGENTS.items() if v["detect"]()}

skill_blast/cli.py

@@ -0,0 +1,528 @@
+"""
+skill-blast CLI — works for both developers (flags) and non-developers (wizard).
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+import platform
+from pathlib import Path
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import (BarColumn, Progress, SpinnerColumn,
+                           TaskProgressColumn, TextColumn, TimeElapsedColumn)
+from rich.prompt import Confirm, Prompt
+from rich.table import Table
+from rich.text import Text
+
+from . import __version__
+from .agents import AGENTS, detect_agents
+from .installer import (check_git, install_skill, uninstall_skill,
+                        health_check, batch_update_repos, CACHE_DIR, STORE_DIR)
+from .skills import (ALL_SKILLS, CATEGORIES, CATEGORY_COLORS,
+                     CATEGORY_ICONS, Skill, SKILLS_BY_ID)
+
+console = Console()
+
+
+# ── UI helpers ─────────────────────────────────────────────────────────────────
+
+BANNER = """[bold cyan]
+  ███████╗██╗  ██╗██╗██╗     ██╗       ██████╗ ██╗      █████╗ ███████╗████████╗
+  ██╔════╝██║ ██╔╝██║██║     ██║       ██╔══██╗██║     ██╔══██╗██╔════╝╚══██╔══╝
+  ███████╗█████╔╝ ██║██║     ██║ █████╗██████╔╝██║     ███████║███████╗   ██║
+  ╚════██║██╔═██╗ ██║██║     ██║ ╚════╝██╔══██╗██║     ██╔══██║╚════██║   ██║
+  ███████║██║  ██╗██║███████╗███████╗  ██████╔╝███████╗██║  ██║███████║   ██║
+  ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝  ╚═════╝ ╚══════╝╚═╝  ╚═╝╚══════╝   ╚═╝
+[/bold cyan]"""
+
+
+def print_banner() -> None:
+    console.print(BANNER)
+    console.print(
+        "[dim]  One-click installer for 50 top AI agent skills[/]"
+        "  ·  [cyan]github.com/Venkatesh-6921/skill-blast[/]\n"
+    )
+
+
+def _cat_display(cat: str) -> str:
+    icon = CATEGORY_ICONS.get(cat, "•")
+    color = CATEGORY_COLORS.get(cat, "white")
+    return f"[{color}]{icon} {cat}[/]"
+
+
+# ── Wizard (non-developer mode) ────────────────────────────────────────────────
+
+def run_wizard() -> tuple[list[str], list[str], bool]:
+    """
+    Interactive step-by-step wizard.
+    Returns: (agent_keys, categories, dry_run)
+    """
+    console.print(Panel(
+        "👋  [bold]Welcome![/]  This wizard will walk you through installing AI skills.\n"
+        "    No coding knowledge needed. Just answer a few questions.\n\n"
+        "    [dim]Press Ctrl+C at any time to cancel.[/]",
+        border_style="cyan",
+    ))
+    console.print()
+
+    # ── Step 1: Agents ─────────────────────────────────────────────────────────
+    detected = detect_agents()
+    console.print("[bold]Step 1 of 3[/] — [cyan]Which AI agents do you use?[/]\n")
+
+    console.print("  Detected on your machine:")
+    if detected:
+        for key, agent in detected.items():
+            console.print(f"    [green]✓[/] {agent['icon']} {agent['name']}")
+    else:
+        console.print("    [yellow]None detected automatically[/]")
+    console.print()
+
+    console.print("  All available agents:")
+    agent_keys = list(AGENTS.keys())
+    for i, (key, agent) in enumerate(AGENTS.items(), 1):
+        mark = "[green]detected[/]" if key in detected else "[dim]not detected[/]"
+        console.print(f"    [bold]{i}[/]. {agent['icon']} {agent['name']:20} {mark}")
+
+    console.print()
+    console.print("  [dim]Enter numbers separated by commas. Press ENTER to use detected agents.[/]")
+    raw = Prompt.ask("  Your choice", default=",".join(str(i) for i, k in enumerate(agent_keys, 1) if k in detected) or "1")
+
+    chosen_agents: list[str] = []
+    if raw.strip().lower() in ("all", "a"):
+        chosen_agents = agent_keys
+    else:
+        for part in raw.split(","):
+            try:
+                idx = int(part.strip()) - 1
+                if 0 <= idx < len(agent_keys):
+                    chosen_agents.append(agent_keys[idx])
+            except ValueError:
+                pass
+
+    if not chosen_agents:
+        chosen_agents = list(detected.keys()) or ["claude-code"]
+
+    console.print()
+    console.print("[green]✓[/] Will install to: " + ", ".join(AGENTS[k]["name"] for k in chosen_agents))
+    console.print()
+
+    # ── Step 2: Categories ─────────────────────────────────────────────────────
+    console.print("[bold]Step 2 of 3[/] — [cyan]Which skill categories do you want?[/]\n")
+
+    cats = sorted(CATEGORIES)
+    for i, cat in enumerate(cats, 1):
+        count = sum(1 for s in ALL_SKILLS if s.category == cat)
+        icon = CATEGORY_ICONS.get(cat, "•")
+        color = CATEGORY_COLORS.get(cat, "white")
+        console.print(f"    [bold]{i}[/]. [{color}]{icon} {cat:20}[/] [dim]({count} skills)[/]")
+
+    console.print()
+    console.print("  [dim]Enter numbers, 'all' for everything, or ENTER for all.[/]")
+    raw2 = Prompt.ask("  Your choice", default="all")
+
+    chosen_cats: list[str] = []
+    if raw2.strip().lower() in ("all", "a", ""):
+        chosen_cats = cats
+    else:
+        for part in raw2.split(","):
+            try:
+                idx = int(part.strip()) - 1
+                if 0 <= idx < len(cats):
+                    chosen_cats.append(cats[idx])
+            except ValueError:
+                pass
+
+    if not chosen_cats:
+        chosen_cats = cats
+
+    skill_count = sum(1 for s in ALL_SKILLS if s.category in chosen_cats)
+    console.print()
+    console.print(f"[green]✓[/] Will install [bold]{skill_count}[/] skills from: " + ", ".join(chosen_cats))
+    console.print()
+
+    # ── Step 3: Confirm ────────────────────────────────────────────────────────
+    console.print("[bold]Step 3 of 3[/] — [cyan]Ready to install?[/]\n")
+    console.print(f"  • [bold]{skill_count}[/] skills")
+    console.print(f"  • Target agents: [bold]{', '.join(AGENTS[k]['name'] for k in chosen_agents)}[/]")
+    console.print(f"  • Cache location: [dim]{CACHE_DIR}[/]")
+    console.print()
+
+    dry = Confirm.ask("  Preview only (dry run, no files written)?", default=False)
+    console.print()
+
+    if not dry:
+        go = Confirm.ask("  [bold green]Start installation?[/]", default=True)
+        if not go:
+            console.print("[yellow]Cancelled.[/]")
+            sys.exit(0)
+
+    return chosen_agents, chosen_cats, dry
+
+
+# ── List all skills ─────────────────────────────────────────────────────────────
+
+def cmd_list(category_filter: list[str] | None = None) -> None:
+    skills = ALL_SKILLS if not category_filter else [s for s in ALL_SKILLS if s.category in category_filter]
+    skills = sorted(skills, key=lambda x: (x.category, x.id))
+
+    table = Table(
+        title=f"[bold]skill-blast — {len(skills)} Skills[/]",
+        border_style="bright_black",
+        show_lines=False,
+        expand=True,
+    )
+    table.add_column("ID", style="dim", width=4, no_wrap=True)
+    table.add_column("Category", width=14)
+    table.add_column("Name", width=24, style="bold")
+    table.add_column("Repo", style="dim cyan", width=34)
+    table.add_column("Description")
+
+    prev_cat = ""
+    for s in skills:
+        cat_display = ""
+        if s.category != prev_cat:
+            cat_display = _cat_display(s.category)
+            prev_cat = s.category
+        table.add_row(str(s.id), cat_display, s.name, s.repo, s.desc)
+
+    console.print(table)
+    console.print(f"\n[dim]Total: {len(skills)} skills across {len(CATEGORIES)} categories[/]")
+
+
+# ── Uninstall ───────────────────────────────────────────────────────────────────
+
+def run_uninstall(
+    skills: list[Skill],
+    agent_dirs: list[Path],
+) -> list[dict]:
+    results: list[dict] = []
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description:<60}"),
+        BarColumn(),
+        TaskProgressColumn(),
+        TimeElapsedColumn(),
+        console=console,
+        transient=False,
+    ) as progress:
+        task = progress.add_task("[red]Uninstalling…", total=len(skills))
+
+        for skill in skills:
+            color = CATEGORY_COLORS.get(skill.category, "white")
+            progress.update(
+                task,
+                description=(
+                    f"[{color}]{CATEGORY_ICONS.get(skill.category, '•')} {skill.category:10}[/] "
+                    f"[bold]{skill.name}[/]"
+                ),
+            )
+            result = uninstall_skill(skill, agent_dirs)
+            results.append(result)
+
+            if result["ok"]:
+                removed = ", ".join(result["removed"])
+                console.log(
+                    f"  [green]✓[/] [bold]{skill.name}[/] removed"
+                    + (f"  ← {removed}" if removed else " (not installed)")
+                )
+            else:
+                console.log(f"  [red]✗[/] [bold]{skill.name}[/]  [red]{result['error']}[/]")
+
+            progress.advance(task)
+
+    return results
+
+
+def print_uninstall_summary(results: list[dict]) -> None:
+    ok = [r for r in results if r["ok"]]
+    removed_count = sum(len(r["removed"]) for r in ok)
+    failed = [r for r in results if not r["ok"]]
+
+    console.print()
+    console.print(Panel(
+        f"[bold green]✓ {len(ok)} processed[/]    "
+        f"[dim]{removed_count} links removed[/]    "
+        + (f"[bold red]✗ {len(failed)} failed[/]" if failed else "[green]0 failures[/]"),
+        title="[bold]Uninstall Summary[/]",
+        border_style="bright_black",
+    ))
+
+
+# ── Health check ────────────────────────────────────────────────────────────────
+
+def cmd_check() -> None:
+    """Run diagnostics on the skill-blast installation."""
+    agent_dirs = [a["skills_dir"] for a in AGENTS.values()]
+    report = health_check(agent_dirs)
+
+    console.print(Panel(
+        "[bold]skill-blast health check[/]",
+        border_style="cyan",
+    ))
+
+    # Git
+    git_icon = "[green]✓[/]" if report["git_ok"] else "[red]✗[/]"
+    console.print(f"  {git_icon} git: {report['git_msg']}")
+
+    # Cache
+    cache_icon = "[green]✓[/]" if report["cache_exists"] else "[yellow]○[/]"
+    console.print(f"  {cache_icon} Cache: {CACHE_DIR}  ({report['cached_repos']} repos)")
+
+    # Store
+    store_icon = "[green]✓[/]" if report["store_exists"] else "[yellow]○[/]"
+    console.print(f"  {store_icon} Store: {STORE_DIR}  ({report['stored_skills']} skills)")
+
+    # Links
+    console.print(f"  [green]✓[/] Healthy links: {report['healthy_links']}")
+
+    if report["broken_links"]:
+        console.print(f"  [red]✗[/] Broken symlinks: {len(report['broken_links'])}")
+        for link in report["broken_links"]:
+            console.print(f"    [red]→[/] {link}")
+        console.print()
+        console.print("  [dim]Tip: run [/][bold]skill-blast --update[/][dim] to repair broken links.[/]")
+    else:
+        console.print(f"  [green]✓[/] No broken symlinks")
+
+    console.print()
+
+
+# ── Progress install ────────────────────────────────────────────────────────────
+
+def run_install(
+    skills: list[Skill],
+    agent_dirs: list[Path],
+    dry_run: bool,
+    update: bool,
+) -> list[dict]:
+    results: list[dict] = []
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description:<60}"),
+        BarColumn(),
+        TaskProgressColumn(),
+        TimeElapsedColumn(),
+        console=console,
+        transient=False,
+    ) as progress:
+        task = progress.add_task("[cyan]Installing…", total=len(skills))
+
+        for skill in skills:
+            color = CATEGORY_COLORS.get(skill.category, "white")
+            progress.update(
+                task,
+                description=(
+                    f"[{color}]{CATEGORY_ICONS.get(skill.category, '•')} {skill.category:10}[/] "
+                    f"[bold]{skill.name}[/]"
+                ),
+            )
+            result = install_skill(skill, agent_dirs, dry_run=dry_run, update=update)
+            results.append(result)
+
+            if result["ok"]:
+                msg = result["repo_msg"]
+                linked = ", ".join(result["linked"])
+                console.log(
+                    f"  [green]✓[/] [bold]{skill.name}[/] "
+                    f"[dim]({msg})[/]"
+                    + (f"  → {linked}" if linked else "")
+                )
+            else:
+                console.log(f"  [red]✗[/] [bold]{skill.name}[/]  [red]{result['error']}[/]")
+
+            progress.advance(task)
+
+    return results
+
+
+# ── Summary ─────────────────────────────────────────────────────────────────────
+
+def print_summary(results: list[dict], agent_names: list[str]) -> None:
+    ok = [r for r in results if r["ok"]]
+    failed = [r for r in results if not r["ok"]]
+    already = sum(len(r["already"]) for r in ok)
+
+    console.print()
+    console.print(Panel(
+        f"[bold green]✓ {len(ok)} installed[/]    "
+        f"[dim]{already} already existed[/]    "
+        + (f"[bold red]✗ {len(failed)} failed[/]" if failed else "[green]0 failures[/]"),
+        title="[bold]Installation Summary[/]",
+        border_style="bright_black",
+    ))
+
+    if failed:
+        table = Table(title="[red]Failed Skills[/]", border_style="red", show_lines=False)
+        table.add_column("ID", width=4, style="dim")
+        table.add_column("Name", style="bold red")
+        table.add_column("Reason")
+        for r in failed:
+            table.add_row(str(r["skill"].id), r["skill"].name, r["error"] or "?")
+        console.print(table)
+
+    console.print()
+    console.print(Panel(
+        f"[bold]Cache:[/]  {CACHE_DIR}\n"
+        f"[bold]Store:[/]  {STORE_DIR}\n\n"
+        "[bold]Next steps by agent:[/]\n"
+        + "\n".join(
+            f"  {AGENTS[k]['icon']} [cyan]{AGENTS[k]['name']:15}[/] {AGENTS[k]['note']}"
+            for k in agent_names
+            if k in AGENTS
+        )
+        + "\n\n[dim]Run [/][bold]skill-blast --update[/][dim] anytime to pull the latest skill versions.[/]",
+        title="[bold green]Done! 🎉[/]",
+        border_style="green",
+    ))
+
+
+# ── Entry point ─────────────────────────────────────────────────────────────────
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="skill-blast",
+        description="One-click installer for 50 top AI agent skills",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  skill-blast                          # interactive wizard (recommended for beginners)
+  skill-blast --all                    # install everything, auto-detect agents
+  skill-blast --agents claude-code opencode
+  skill-blast --only Engineering "UI/Design"
+  skill-blast --skip 41 49 50
+  skill-blast --update                 # pull latest for cached repos
+  skill-blast --dry-run                # preview without writing files
+  skill-blast --list                   # show all 50 skills
+  skill-blast --list --only Marketing  # filter list by category
+  skill-blast --uninstall              # remove all installed skills
+  skill-blast --uninstall --only Media # remove only Media skills
+  skill-blast --check                  # run health diagnostics
+        """,
+    )
+    parser.add_argument("--version", action="version",
+                        version=f"%(prog)s {__version__}")
+    parser.add_argument("--agents", nargs="+", choices=list(AGENTS), metavar="AGENT",
+                        help="Target specific agents (default: auto-detect)")
+    parser.add_argument("--all", action="store_true",
+                        help="Install all skills to all detected agents")
+    parser.add_argument("--only", nargs="+", metavar="CATEGORY",
+                        help=f"Install only these categories: {', '.join(CATEGORIES)}")
+    parser.add_argument("--skip", nargs="+", type=int, metavar="ID",
+                        help="Skill IDs to skip")
+    parser.add_argument("--update", action="store_true",
+                        help="Pull latest for already-cached repos")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="Preview without writing any files")
+    parser.add_argument("--list", action="store_true",
+                        help="List all skills and exit")
+    parser.add_argument("--uninstall", action="store_true",
+                        help="Remove installed skills from agent directories")
+    parser.add_argument("--check", action="store_true",
+                        help="Run health diagnostics on your skill-blast installation")
+    parser.add_argument("--force-agents", action="store_true",
+                        help="Install to ALL agents even if not detected")
+    parser.add_argument("--no-wizard", action="store_true",
+                        help="Skip interactive wizard; use flags only")
+    args = parser.parse_args()
+
+    # ── List only ──────────────────────────────────────────────────────────────
+    if args.list:
+        print_banner()
+        cmd_list(category_filter=args.only)
+        return
+
+    # ── Health check ──────────────────────────────────────────────────────────
+    if args.check:
+        print_banner()
+        cmd_check()
+        return
+
+    print_banner()
+
+    # ── Git check ──────────────────────────────────────────────────────────────
+    git_ok, git_msg = check_git()
+    if not git_ok:
+        console.print(Panel(
+            "[bold red]git is not installed or not in PATH.[/]\n\n"
+            "Please install git first:\n"
+            "  • [cyan]Windows[/]:  https://git-scm.com/download/win\n"
+            "  • [cyan]macOS[/]:    brew install git  (or via Xcode tools)\n"
+            "  • [cyan]Linux[/]:    sudo apt install git   /   sudo dnf install git\n\n"
+            "Then re-run skill-blast.",
+            title="[red]Missing dependency[/]",
+            border_style="red",
+        ))
+        sys.exit(1)
+
+    # ── Decide: wizard or flags ────────────────────────────────────────────────
+    use_wizard = not (args.all or args.agents or args.only or args.skip
+                      or args.dry_run or args.no_wizard or args.uninstall)
+
+    if use_wizard:
+        # Non-developer path
+        chosen_agent_keys, chosen_cats, dry_run = run_wizard()
+    else:
+        # Developer / flag path
+        dry_run = args.dry_run
+
+        if args.agents:
+            chosen_agent_keys = args.agents
+        elif args.force_agents:
+            chosen_agent_keys = list(AGENTS.keys())
+        else:
+            detected = detect_agents()
+            chosen_agent_keys = list(detected.keys()) or ["claude-code"]
+            if chosen_agent_keys == ["claude-code"]:
+                console.print("[yellow]No agents detected — defaulting to Claude Code.[/]\n")
+
+        chosen_cats = args.only if args.only else CATEGORIES
+
+    # ── Filter skills ──────────────────────────────────────────────────────────
+    skills = [s for s in ALL_SKILLS if s.category in chosen_cats]
+    if args.skip:
+        skills = [s for s in skills if s.id not in args.skip]
+
+    agent_dirs = [AGENTS[k]["skills_dir"] for k in chosen_agent_keys]
+
+    # ── Status line ────────────────────────────────────────────────────────────
+    console.print(f"[bold]Agents:[/] {', '.join(AGENTS[k]['name'] for k in chosen_agent_keys)}")
+    console.print(f"[bold]Skills:[/] {len(skills)}  "
+                  f"[dim]({', '.join(chosen_cats)})[/]")
+    if dry_run:
+        console.print("[bold yellow]DRY RUN — no files will be written[/]")
+    console.print()
+
+    # ── Uninstall path ─────────────────────────────────────────────────────────
+    if args.uninstall:
+        console.print(f"[bold red]Uninstalling {len(skills)} skills…[/]\n")
+        results = run_uninstall(skills, agent_dirs)
+        print_uninstall_summary(results)
+        return
+
+    # ── Concurrent repo update ─────────────────────────────────────────────────
+    if args.update and not dry_run:
+        unique_repos = sorted(set(s.repo for s in skills))
+        console.print(f"[cyan]Updating {len(unique_repos)} repos concurrently (4 threads)…[/]\n")
+        repo_results = batch_update_repos(unique_repos, max_workers=4)
+        ok_count = sum(1 for ok, _ in repo_results.values() if ok)
+        fail_count = len(repo_results) - ok_count
+        console.print(
+            f"  [green]✓ {ok_count} repos updated[/]"
+            + (f"  [red]✗ {fail_count} failed[/]" if fail_count else "")
+            + "\n"
+        )
+
+    # ── Install ────────────────────────────────────────────────────────────────
+    results = run_install(skills, agent_dirs, dry_run=dry_run, update=False if args.update else False)
+
+    # ── Summary ────────────────────────────────────────────────────────────────
+    print_summary(results, chosen_agent_keys)
+
+
+if __name__ == "__main__":
+    main()