@elisym/cli 0.1.0

package/skills-examples/site-status/scripts/site_status.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""Check website status, response time, and SSL."""
+
+import json
+import ssl
+import sys
+import time
+from urllib.parse import urlparse
+
+import requests
+
+
+def check_ssl(hostname):
+    """Check if SSL certificate is valid."""
+    try:
+        ctx = ssl.create_default_context()
+        with ctx.wrap_socket(ssl.socket(), server_hostname=hostname) as s:
+            s.settimeout(5)
+            s.connect((hostname, 443))
+        return True
+    except Exception:
+        return False
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({"error": "Usage: site_status.py <url>"}))
+        sys.exit(1)
+
+    url = sys.argv[1]
+    if not url.startswith(("http://", "https://")):
+        url = "https://" + url
+
+    parsed = urlparse(url)
+
+    try:
+        start = time.time()
+        resp = requests.get(url, timeout=15, allow_redirects=True)
+        elapsed_ms = round((time.time() - start) * 1000)
+    except requests.exceptions.ConnectionError:
+        print(json.dumps({"url": url, "error": "Connection failed", "status": "down"}))
+        sys.exit(1)
+    except requests.exceptions.Timeout:
+        print(json.dumps({"url": url, "error": "Timeout", "status": "timeout"}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"url": url, "error": str(e)}))
+        sys.exit(1)
+
+    redirect_chain = []
+    for r in resp.history:
+        redirect_chain.append({
+            "url": r.url,
+            "status_code": r.status_code,
+        })
+
+    ssl_valid = None
+    if parsed.scheme == "https" or resp.url.startswith("https://"):
+        final_host = urlparse(resp.url).hostname
+        ssl_valid = check_ssl(final_host)
+
+    result = {
+        "url": resp.url,
+        "status_code": resp.status_code,
+        "response_time_ms": elapsed_ms,
+        "redirect_chain": redirect_chain if redirect_chain else None,
+        "ssl_valid": ssl_valid,
+        "server": resp.headers.get("Server"),
+    }
+
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/skills-examples/stock-price/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: stock-price
+description: Stock quote agent. Send a ticker (e.g. AAPL) - get price, daily change, volume, and 52-week range
+capabilities:
+  - stock-price
+  - stocks
+tools:
+  - name: get_quote
+    description: Get current stock quote for a ticker symbol. Returns JSON with ticker, name, price, change, change_percent, volume, market_cap, 52w_high, 52w_low.
+    command: ['python3', 'scripts/stock_price.py']
+    parameters:
+      - name: ticker
+        description: Stock ticker symbol (e.g. AAPL, GOOGL, TSLA)
+        required: true
+---
+
+You are a stock price agent.
+
+When asked about stock prices:
+
+1. Use the get_quote tool with the ticker symbol
+2. Present price, daily change, volume, and market cap
+3. Include 52-week high/low for context
+
+IMPORTANT: Output plain text only. No markdown formatting (no #, \*\*, -, ```, etc.). Use simple line breaks and dashes for structure.

package/skills-examples/stock-price/scripts/stock_price.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""Fetch stock quote using yfinance."""
+
+import json
+import sys
+
+import yfinance as yf
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({"error": "Usage: stock_price.py <ticker>"}))
+        sys.exit(1)
+
+    ticker = sys.argv[1].upper()
+
+    try:
+        stock = yf.Ticker(ticker)
+        info = stock.info
+    except Exception as e:
+        print(json.dumps({"error": f"yfinance failed: {e}"}))
+        sys.exit(1)
+
+    if not info or info.get("regularMarketPrice") is None:
+        print(json.dumps({"error": f"No data found for ticker '{ticker}'"}))
+        sys.exit(1)
+
+    price = info.get("regularMarketPrice") or info.get("currentPrice")
+    prev_close = info.get("regularMarketPreviousClose")
+    change = round(price - prev_close, 2) if price and prev_close else None
+    change_pct = round((change / prev_close) * 100, 2) if change and prev_close else None
+
+    result = {
+        "ticker": ticker,
+        "name": info.get("shortName") or info.get("longName"),
+        "price": price,
+        "change": change,
+        "change_percent": change_pct,
+        "volume": info.get("regularMarketVolume"),
+        "market_cap": info.get("marketCap"),
+        "52w_high": info.get("fiftyTwoWeekHigh"),
+        "52w_low": info.get("fiftyTwoWeekLow"),
+    }
+
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/skills-examples/trending/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: trending
+description: Trending agent. Ask for GitHub or Reddit trends - get a ranked list of top repos or posts
+capabilities:
+  - trending
+  - popular
+tools:
+  - name: get_trending
+    description: Get trending items from GitHub or Reddit. Returns JSON array of [{rank, title, url, description, score/stars}, ...]. No API key needed.
+    command: ['python3', 'scripts/trending.py']
+    parameters:
+      - name: source
+        description: "Source to fetch from: 'github' or 'reddit'"
+        required: true
+      - name: category
+        description: 'For GitHub: language filter (e.g. python, rust). For Reddit: subreddit name (e.g. technology, programming). Default: all/popular'
+        required: false
+---
+
+You are a trending content agent.
+
+When asked about what's trending:
+
+1. Use the get_trending tool with the appropriate source
+2. Present the top items with rank, title, description, and score
+3. You can query both GitHub and Reddit if the user wants a broad overview
+
+IMPORTANT: Output plain text only. No markdown formatting (no #, \*\*, -, ```, etc.). Use simple line breaks and dashes for structure.

package/skills-examples/trending/scripts/trending.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""Fetch trending repos from GitHub or posts from Reddit."""
+
+import json
+import sys
+
+import requests
+from bs4 import BeautifulSoup
+
+
+def github_trending(language=None):
+    """Scrape GitHub trending page."""
+    url = "https://github.com/trending"
+    if language:
+        url += f"/{language}"
+
+    headers = {"User-Agent": "Mozilla/5.0 (compatible; elisym-agent/1.0)"}
+
+    try:
+        resp = requests.get(url, headers=headers, timeout=15)
+        resp.raise_for_status()
+    except Exception as e:
+        return {"error": f"Failed to fetch GitHub trending: {e}"}
+
+    soup = BeautifulSoup(resp.text, "html.parser")
+    articles = soup.select("article.Box-row")
+
+    results = []
+    for i, article in enumerate(articles[:25], 1):
+        h2 = article.select_one("h2 a")
+        if not h2:
+            continue
+        repo_path = h2.get("href", "").strip("/")
+        name = repo_path
+
+        desc_p = article.select_one("p")
+        description = desc_p.get_text(strip=True) if desc_p else None
+
+        stars_el = article.select_one("a[href$='/stargazers']")
+        stars = stars_el.get_text(strip=True).replace(",", "") if stars_el else None
+
+        lang_el = article.select_one("[itemprop='programmingLanguage']")
+        lang = lang_el.get_text(strip=True) if lang_el else None
+
+        results.append({
+            "rank": i,
+            "title": name,
+            "url": f"https://github.com/{repo_path}",
+            "description": description,
+            "stars": stars,
+            "language": lang,
+        })
+
+    return results
+
+
+def reddit_trending(subreddit=None):
+    """Fetch hot posts from Reddit."""
+    sub = subreddit or "popular"
+    url = f"https://old.reddit.com/r/{sub}/.json?limit=25"
+    headers = {"User-Agent": "elisym-agent/1.0"}
+
+    try:
+        resp = requests.get(url, headers=headers, timeout=15)
+        resp.raise_for_status()
+        data = resp.json()
+    except Exception as e:
+        return {"error": f"Failed to fetch Reddit: {e}"}
+
+    results = []
+    children = data.get("data", {}).get("children", [])
+    for i, child in enumerate(children, 1):
+        post = child.get("data", {})
+        results.append({
+            "rank": i,
+            "title": post.get("title"),
+            "url": f"https://reddit.com{post.get('permalink', '')}",
+            "description": post.get("selftext", "")[:200] or None,
+            "score": post.get("score"),
+            "subreddit": post.get("subreddit"),
+        })
+
+    return results
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({"error": "Usage: trending.py <github|reddit> [category]"}))
+        sys.exit(1)
+
+    source = sys.argv[1].lower()
+    category = sys.argv[2] if len(sys.argv) > 2 else None
+
+    if source == "github":
+        result = github_trending(category)
+    elif source == "reddit":
+        result = reddit_trending(category)
+    else:
+        result = {"error": f"Unknown source: {source}. Use 'github' or 'reddit'"}
+
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/skills-examples/whois-lookup/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: whois-lookup
+description: WHOIS agent. Send a domain - get registrar, dates, name servers, and status
+capabilities:
+  - whois-lookup
+  - domain-info
+tools:
+  - name: whois_domain
+    description: Look up WHOIS registration info for a domain. Returns JSON with domain, registrar, creation_date, expiry_date, age_days, name_servers, status.
+    command: ['python3', 'scripts/whois_lookup.py']
+    parameters:
+      - name: domain
+        description: Domain name to look up (e.g. example.com)
+        required: true
+---
+
+You are a domain WHOIS lookup agent.
+
+When given a request about a domain:
+
+1. Use the whois_domain tool to fetch registration information
+2. Present the results clearly to the user
+
+IMPORTANT: Output plain text only. No markdown formatting (no #, \*\*, -, ```, etc.). Use simple line breaks and dashes for structure.
+
+Include: registrar, registration and expiry dates, domain age, name servers, and current status.

package/skills-examples/whois-lookup/scripts/whois_lookup.py

@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+"""WHOIS lookup for a domain."""
+
+import json
+import sys
+from datetime import datetime, timezone
+
+import whois
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({"error": "Usage: whois_lookup.py <domain>"}))
+        sys.exit(1)
+
+    domain = sys.argv[1]
+
+    try:
+        w = whois.whois(domain)
+    except Exception as e:
+        print(json.dumps({"error": f"WHOIS lookup failed: {e}"}))
+        sys.exit(1)
+
+    creation = w.creation_date
+    if isinstance(creation, list):
+        creation = creation[0]
+
+    expiry = w.expiration_date
+    if isinstance(expiry, list):
+        expiry = expiry[0]
+
+    age_days = None
+    if creation:
+        now = datetime.now(timezone.utc)
+        if creation.tzinfo is None:
+            creation = creation.replace(tzinfo=timezone.utc)
+        age_days = (now - creation).days
+
+    name_servers = w.name_servers
+    if name_servers and isinstance(name_servers, (list, set)):
+        name_servers = sorted(set(ns.lower() for ns in name_servers))
+
+    status = w.status
+    if isinstance(status, list):
+        status = status
+    elif status:
+        status = [status]
+    else:
+        status = []
+
+    result = {
+        "domain": w.domain_name if w.domain_name else domain,
+        "registrar": w.registrar,
+        "creation_date": str(creation) if creation else None,
+        "expiry_date": str(expiry) if expiry else None,
+        "age_days": age_days,
+        "name_servers": name_servers,
+        "status": status,
+    }
+
+    print(json.dumps(result, indent=2, default=str))
+
+
+if __name__ == "__main__":
+    main()

package/skills-examples/youtube-summary/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: youtube-summary
+description: YouTube summary agent. Send a link - get overview, key points, and takeaways
+capabilities:
+  - youtube-summary
+  - video-analysis
+max_tool_rounds: 15
+tools:
+  - name: fetch_transcript
+    description: Fetch transcript from a YouTube video. Returns JSON with title, channel, duration_min, language, total_chunks, chunk (current chunk index), and transcript (text of chunk 0). If total_chunks > 1, use read_chunk to get remaining chunks.
+    command: ['python3', 'scripts/summarize.py', '--lang', 'auto']
+    parameters:
+      - name: url
+        description: YouTube video URL
+        required: true
+  - name: read_chunk
+    description: Read a specific chunk of a previously fetched transcript. Use this after fetch_transcript when total_chunks > 1. Returns JSON with title, chunk, total_chunks, and transcript text for that chunk.
+    command: ['python3', 'scripts/summarize.py']
+    parameters:
+      - name: url
+        description: Same YouTube URL used in fetch_transcript
+        required: true
+      - name: chunk
+        description: Chunk index to read (0-indexed). Start from 1 since fetch_transcript already returns chunk 0.
+        required: true
+---
+
+You are a YouTube video summarizer.
+
+When given a request:
+
+1. Call fetch_transcript with the video URL
+2. Check total_chunks in the response:
+   - If total_chunks is 1: you have the full transcript, summarize it
+   - If total_chunks > 1: you already have chunk 0. Call read_chunk for chunks 1, 2, ... up to total_chunks-1, one at a time. After reading each chunk, note its key points. After all chunks are read, write a combined summary.
+3. Write the summary in the language the user used. If only a URL was sent, use the video's language.
+
+IMPORTANT: Output plain text only. No markdown formatting (no #, \*\*, -, ```, etc.). Use simple line breaks and dashes for structure.
+
+Summary format:
+2-3 sentence overview
+Key points (use dashes for lists)
+Important quotes, numbers, or facts mentioned
+Brief conclusion / takeaway