From 3caf59112f1160fa7c3c5ac20727878a20f32bcc Mon Sep 17 00:00:00 2001
From: Arun Kumar Thiagarajan <arunkt.bm14@gmail.com>
Date: Tue, 24 Mar 2026 14:47:53 +0530
Subject: [PATCH] =?UTF-8?q?feat:=20gstack-skill-search=20=E2=80=94=20disco?=
 =?UTF-8?q?ver=20community=20skills=20on=20GitHub?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Uses GitHub search API to find repos with topic "gstack-skill".
Stars = ratings, repos = skills, zero new infrastructure.

Usage:
  gstack-skill-search                # browse all
  gstack-skill-search security       # search by keyword
  gstack-skill-search --popular      # sort by stars
  gstack-skill-search --json         # machine-readable

Publishing: gh repo edit --add-topic gstack-skill
---
 bin/gstack-skill-search | 77 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100755 bin/gstack-skill-search

diff --git a/bin/gstack-skill-search b/bin/gstack-skill-search
new file mode 100755
index 00000000..5bab631c
--- /dev/null
+++ b/bin/gstack-skill-search
@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# gstack-skill-search — discover community skills on GitHub
+#
+# Uses GitHub's search API to find gstack skill repositories.
+# Skills are GitHub repos with topic "gstack-skill" and a SKILL.md.tmpl.
+#
+# Usage:
+#   gstack-skill-search                    # browse all community skills
+#   gstack-skill-search security           # search by keyword
+#   gstack-skill-search --popular          # sort by stars
+#   gstack-skill-search --recent           # sort by recently updated
+#   gstack-skill-search --json             # machine-readable output
+#
+# Publishing: add topic "gstack-skill" to your repo:
+#   gh repo edit --add-topic gstack-skill
+set -euo pipefail
+
+QUERY=""
+SORT="stars"
+JSON_MODE=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --popular) SORT="stars" ;;
+    --recent) SORT="updated" ;;
+    --json) JSON_MODE=1 ;;
+    --help|-h) echo "Usage: gstack-skill-search [query] [--popular|--recent] [--json]"; exit 0 ;;
+    -*) ;;
+    *) QUERY="$arg" ;;
+  esac
+done
+
+# Build search query
+SEARCH="topic:gstack-skill"
+[ -n "$QUERY" ] && SEARCH="$QUERY $SEARCH"
+
+# Search GitHub
+RESULTS=$(gh search repos "$SEARCH" --sort "$SORT" --limit 20 \
+  --json fullName,description,stargazersCount,updatedAt,url \
+  2>/dev/null || echo "[]")
+
+if [ "$JSON_MODE" = "1" ]; then
+  echo "$RESULTS"
+  exit 0
+fi
+
+COUNT=$(echo "$RESULTS" | python3 -c "import json,sys;print(len(json.load(sys.stdin)))" 2>/dev/null || echo 0)
+
+if [ "$COUNT" = "0" ]; then
+  echo "No community skills found."
+  echo ""
+  echo "Publish yours: add topic 'gstack-skill' to your repo"
+  echo "  gh repo edit --add-topic gstack-skill"
+  exit 0
+fi
+
+echo "COMMUNITY SKILLS ($COUNT found, sorted by $SORT)"
+echo "═══════════════════════════════════════════════════"
+echo ""
+
+echo "$RESULTS" | python3 -c "
+import json, sys
+results = json.load(sys.stdin)
+for r in results:
+    stars = r.get('stargazersCount', 0)
+    name = r.get('fullName', '')
+    desc = (r.get('description', '') or '')[:60]
+    updated = r.get('updatedAt', '')[:10]
+    star_icon = '★' if stars > 10 else '☆'
+    print(f'  {star_icon} {stars:3d}  {name}')
+    print(f'         {desc}')
+    print(f'         Updated: {updated}  Install: gstack-skill-install {name}')
+    print()
+" 2>/dev/null
+
+echo "Install: gstack-skill-install <owner/repo>"
+echo "Publish: gh repo edit --add-topic gstack-skill"