skills

1#!/usr/bin/env python3
2"""Check whether skill directories have pending git updates or local changes.
3 
4Usage: check_skill_update.py [DIR ...] [--fetch]
5 
6Inspects git status and branch tracking for skill directories.
7When no directory is specified, checks default skill locations:
8- current directory
9- ~/.copilot/skills
10- ~/.gemini/antigravity-cli/skills
11- ~/.gemini/config/skills
12- ~/.claude/skills
13- ~/.agents/skills
14"""
15 
16import argparse
17import os
18import subprocess
19import sys
20 
21DEFAULT_HOMES = [
22    ".",
23    os.path.expanduser("~/.copilot/skills"),
24    os.path.expanduser("~/.gemini/antigravity-cli/skills"),
25    os.path.expanduser("~/.gemini/config/skills"),
26    os.path.expanduser("~/.claude/skills"),
27    os.path.expanduser("~/.agents/skills"),
28]
29 
30 
31def run_git(cmd, cwd, timeout=10):
32    try:
33        res = subprocess.run(
34            ["git", "-C", cwd] + cmd,
35            capture_output=True,
36            text=True,
37            timeout=timeout,
38        )
39        return res.returncode, res.stdout.strip(), res.stderr.strip()
40    except Exception as exc:
41        return 1, "", str(exc)
42 
43 
44def inspect_skill_repo(target_dir, fetch=True):
45    path = os.path.abspath(target_dir)
46    if not os.path.isdir(path):
47        return {"path": path, "status": "missing", "detail": "directory not found"}
48 
49    code, toplevel, _ = run_git(["rev-parse", "--show-toplevel"], path)
50    if code != 0 or not toplevel:
51        return {"path": path, "status": "not_git", "detail": "not a git repository"}
52 
53    repo_dir = toplevel
54    if fetch:
55        # Dry-run fetch to see if upstream has newer commits without altering local branches
56        run_git(["fetch", "--dry-run"], repo_dir, timeout=8)
57 
58    code, status_out, _ = run_git(["status", "--short", "--branch"], repo_dir)
59    if code != 0:
60        return {"path": repo_dir, "status": "error", "detail": "git status failed"}
61 
62    lines = status_out.splitlines()
63    branch_line = lines[0] if lines else "## unknown"
64    dirty_files = [line for line in lines[1:] if line.strip()]
65 
66    is_behind = "behind" in branch_line
67    is_ahead = "ahead" in branch_line
68    is_diverged = is_behind and is_ahead
69    is_dirty = len(dirty_files) > 0
70 
71    if is_diverged:
72        status = "diverged"
73        detail = branch_line.lstrip("# ").strip()
74    elif is_behind:
75        status = "behind"
76        detail = branch_line.lstrip("# ").strip()
77    elif is_ahead:
78        status = "ahead"
79        detail = branch_line.lstrip("# ").strip()
80    elif is_dirty:
81        status = "dirty"
82        detail = f"{len(dirty_files)} uncommitted file(s)"
83    else:
84        status = "clean"
85        detail = branch_line.lstrip("# ").strip()
86 
87    return {
88        "path": repo_dir,
89        "status": status,
90        "detail": detail,
91        "branch_line": branch_line,
92        "dirty_count": len(dirty_files),
93        "is_behind": is_behind,
94    }
95 
96 
97def main():
98    parser = argparse.ArgumentParser(description="Check git status for skill directories.")
99    parser.add_argument("dirs", nargs="*", help="Skill directories to inspect")
100    parser.add_argument("--fetch", action="store_true", default=True, help="Fetch from remote (default: True)")
101    parser.add_argument("--no-fetch", action="store_false", dest="fetch", help="Skip remote fetch")
102    args = parser.parse_args()
103 
104    targets = args.dirs if args.dirs else DEFAULT_HOMES
105    seen = set()
106    results = []
107 
108    for item in targets:
109        real = os.path.realpath(os.path.abspath(item))
110        if real in seen or not os.path.isdir(real):
111            continue
112        seen.add(real)
113        results.append(inspect_skill_repo(real, fetch=args.fetch))
114 
115    if not results:
116        print("No existing skill directories found to check.")
117        return 0
118 
119    print("Skill folder update check:")
120    has_behind = False
121    for r in results:
122        path = r["path"]
123        status = r["status"]
124        detail = r.get("detail", "")
125        if status == "behind" or status == "diverged":
126            has_behind = True
127            print(f"  [STALE] {path}: {detail} (run 'git -C {path} pull' to update)")
128        elif status == "clean":
129            print(f"  [OK]    {path}: up to date ({detail})")
130        elif status == "dirty":
131            print(f"  [INFO]  {path}: local changes present ({detail})")
132        elif status == "ahead":
133            print(f"  [INFO]  {path}: ahead of upstream ({detail})")
134        elif status == "not_git":
135            print(f"  [INFO]  {path}: not a git repository (standalone files)")
136        else:
137            print(f"  [INFO]  {path}: {status} ({detail})")
138 
139    if has_behind:
140        print("\nOne or more skill folders have updates available upstream.")
141        return 1
142 
143    return 0
144 
145 
146if __name__ == "__main__":
147    sys.exit(main())
148