Skill Search

{
  "$schema": "https://agentskills.io/schemas/manifest.v1.json",
  "manifestVersion": "1.0",
  "generatedAt": "2026-01-03T03:32:17.276938Z",
  "generator": "skill-manifest-generator/1.0.0",
  "skill": {
    "name": "skill-search",
    "version": "1.0.0"
  },
  "integrity": {
    "algorithm": "sha256",
    "hash": "879a786ccd22c29248abbe8651f05090f8cf5eab4cece3bd2bd776afe497edb9"
  },
  "files": [
    {
      "path": "SKILL.md",
      "size": 2155,
      "sha256": "a58adfb365cae0c21380f0a116298fcdc6d351def832adcb935088f4f47658ff",
      "type": "manifest"
    },
    {
      "path": "scripts/search_catalog.py",
      "size": 8117,
      "sha256": "4e1c61f1a94e7a1c4277168d320befa67733a82f26d9b6120f1a1c8756511c8a",
      "type": "script"
    }
  ],
  "externalReferences": [
    {
      "url": "https://skillscatalog.ai/settings/skill-keys",
      "file": "SKILL.md",
      "line": 19,
      "type": "unknown"
    }
  ],
  "structure": {
    "maxDepth": 1,
    "totalFiles": 2,
    "totalBytes": 10272,
    "folders": [
      "scripts"
    ]
  },
  "license": {
    "spdxId": "MIT"
  }
}


#!/usr/bin/env python3
"""
Agent Skills Catalog Search

Search the skillscatalog.ai catalog for skills.
"""

import argparse
import json
import sys
from pathlib import Path
from typing import Optional

# Add parent directory to path for shared imports
SCRIPT_DIR = Path(__file__).parent
SKILLS_DIR = SCRIPT_DIR.parent.parent
SHARED_DIR = SKILLS_DIR / "_shared"
sys.path.insert(0, str(SHARED_DIR))

try:
    from agentskills_config import get_skill_key, get_api_url, get_auth_header
except ImportError:
    print("Error: Could not import agentskills_config.")
    print("Make sure the _shared/agentskills_config.py module exists.")
    sys.exit(1)

# Optional: import requests
try:
    import requests
except ImportError:
    requests = None  # type: ignore


# ============================================================================
# API Functions
# ============================================================================

def search_catalog(query: str, limit: int = 20) -> dict:
    """Search the catalog for skills."""
    if requests is None:
        return {
            "error": "requests library not installed. Run: pip install requests",
            "results": [],
        }

    api_url = get_api_url()
    headers = get_auth_header()

    try:
        response = requests.get(
            f"{api_url}/api/catalog/search",
            headers=headers,
            params={"q": query},
            timeout=30,
        )

        if response.status_code == 200:
            data = response.json()
            results = data.get("results", [])[:limit]
            return {"results": results, "query": query, "count": len(results)}
        else:
            try:
                error_data = response.json()
                return {"error": error_data.get("error", f"HTTP {response.status_code}"), "results": []}
            except json.JSONDecodeError:
                return {"error": f"HTTP {response.status_code}", "results": []}

    except requests.exceptions.Timeout:
        return {"error": "Request timed out", "results": []}
    except requests.exceptions.ConnectionError:
        return {"error": f"Could not connect to {api_url}", "results": []}
    except Exception as e:
        return {"error": str(e), "results": []}


def get_skill(vendor_key: str, skill_key: str) -> dict:
    """Get details for a specific skill."""
    if requests is None:
        return {"error": "requests library not installed. Run: pip install requests"}

    api_url = get_api_url()
    headers = get_auth_header()

    try:
        response = requests.get(
            f"{api_url}/api/catalog/{vendor_key}/{skill_key}",
            headers=headers,
            timeout=30,
        )

        if response.status_code == 200:
            return response.json()
        elif response.status_code == 404:
            return {"error": f"Skill not found: {vendor_key}/{skill_key}"}
        else: