sophhub 0.4.19 → 0.4.21

package/skills/weather/src/SKILL.md

@@ -1,112 +1,112 @@
----
-name: weather
-description: "Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed."
-homepage: https://wttr.in/:help
-metadata: { "openclaw": { "emoji": "🌤️", "requires": { "bins": ["curl"] } } }
----
-
-# Weather Skill
-
-Get current weather conditions and forecasts.
-
-## When to Use
-
-✅ **USE this skill when:**
-
-- "What's the weather?"
-- "Will it rain today/tomorrow?"
-- "Temperature in [city]"
-- "Weather forecast for the week"
-- Travel planning weather checks
-
-## When NOT to Use
-
-❌ **DON'T use this skill when:**
-
-- Historical weather data → use weather archives/APIs
-- Climate analysis or trends → use specialized data sources
-- Hyper-local microclimate data → use local sensors
-- Severe weather alerts → check official NWS sources
-- Aviation/marine weather → use specialized services (METAR, etc.)
-
-## Location
-
-Always include a city, region, or airport code in weather queries.
-
-## Commands
-
-### Current Weather
-
-```bash
-# One-line summary
-curl "wttr.in/London?format=3"
-
-# Detailed current conditions
-curl "wttr.in/London?0"
-
-# Specific city
-curl "wttr.in/New+York?format=3"
-```
-
-### Forecasts
-
-```bash
-# 3-day forecast
-curl "wttr.in/London"
-
-# Week forecast
-curl "wttr.in/London?format=v2"
-
-# Specific day (0=today, 1=tomorrow, 2=day after)
-curl "wttr.in/London?1"
-```
-
-### Format Options
-
-```bash
-# One-liner
-curl "wttr.in/London?format=%l:+%c+%t+%w"
-
-# JSON output
-curl "wttr.in/London?format=j1"
-
-# PNG image
-curl "wttr.in/London.png"
-```
-
-### Format Codes
-
-- `%c` — Weather condition emoji
-- `%t` — Temperature
-- `%f` — "Feels like"
-- `%w` — Wind
-- `%h` — Humidity
-- `%p` — Precipitation
-- `%l` — Location
-
-## Quick Responses
-
-**"What's the weather?"**
-
-```bash
-curl -s "wttr.in/London?format=%l:+%c+%t+(feels+like+%f),+%w+wind,+%h+humidity"
-```
-
-**"Will it rain?"**
-
-```bash
-curl -s "wttr.in/London?format=%l:+%c+%p"
-```
-
-**"Weekend forecast"**
-
-```bash
-curl "wttr.in/London?format=v2"
-```
-
-## Notes
-
-- No API key needed (uses wttr.in)
-- Rate limited; don't spam requests
-- Works for most global cities
-- Supports airport codes: `curl wttr.in/ORD`
+---
+name: weather
+description: "Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed."
+homepage: https://wttr.in/:help
+metadata: { "openclaw": { "emoji": "🌤️", "requires": { "bins": ["curl"] } } }
+---
+
+# Weather Skill
+
+Get current weather conditions and forecasts.
+
+## When to Use
+
+✅ **USE this skill when:**
+
+- "What's the weather?"
+- "Will it rain today/tomorrow?"
+- "Temperature in [city]"
+- "Weather forecast for the week"
+- Travel planning weather checks
+
+## When NOT to Use
+
+❌ **DON'T use this skill when:**
+
+- Historical weather data → use weather archives/APIs
+- Climate analysis or trends → use specialized data sources
+- Hyper-local microclimate data → use local sensors
+- Severe weather alerts → check official NWS sources
+- Aviation/marine weather → use specialized services (METAR, etc.)
+
+## Location
+
+Always include a city, region, or airport code in weather queries.
+
+## Commands
+
+### Current Weather
+
+```bash
+# One-line summary
+curl "wttr.in/London?format=3"
+
+# Detailed current conditions
+curl "wttr.in/London?0"
+
+# Specific city
+curl "wttr.in/New+York?format=3"
+```
+
+### Forecasts
+
+```bash
+# 3-day forecast
+curl "wttr.in/London"
+
+# Week forecast
+curl "wttr.in/London?format=v2"
+
+# Specific day (0=today, 1=tomorrow, 2=day after)
+curl "wttr.in/London?1"
+```
+
+### Format Options
+
+```bash
+# One-liner
+curl "wttr.in/London?format=%l:+%c+%t+%w"
+
+# JSON output
+curl "wttr.in/London?format=j1"
+
+# PNG image
+curl "wttr.in/London.png"
+```
+
+### Format Codes
+
+- `%c` — Weather condition emoji
+- `%t` — Temperature
+- `%f` — "Feels like"
+- `%w` — Wind
+- `%h` — Humidity
+- `%p` — Precipitation
+- `%l` — Location
+
+## Quick Responses
+
+**"What's the weather?"**
+
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%t+(feels+like+%f),+%w+wind,+%h+humidity"
+```
+
+**"Will it rain?"**
+
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%p"
+```
+
+**"Weekend forecast"**
+
+```bash
+curl "wttr.in/London?format=v2"
+```
+
+## Notes
+
+- No API key needed (uses wttr.in)
+- Rate limited; don't spam requests
+- Works for most global cities
+- Supports airport codes: `curl wttr.in/ORD`

package/skills/web-scraper/skill.json

@@ -1,20 +1,20 @@
-{
-  "name": "web-scraper",
-  "version": "1.0.0",
-  "types": [
-    "builtin"
-  ],
-  "displayName": "",
-  "description": "",
-  "changelog": [
-    {
-      "version": "1.0.0",
-      "date": "2026-04-09",
-      "changes": [
-        "初次提交"
-      ]
-    }
-  ],
-  "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
-}
+{
+  "name": "web-scraper",
+  "version": "1.0.0",
+  "types": [
+    "builtin"
+  ],
+  "displayName": "",
+  "description": "",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-09",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-04-09"
+}

package/skills/web-scraper/src/SKILL.md

@@ -1,101 +1,101 @@
----
-name: web-scraper
-description: Scrape web pages on the server side. Supports static HTTP scraping (curl) and dynamic JavaScript rendering (Chrome print-to-pdf + PyMuPDF). Zero extra pip dependencies. Use when web_fetch returns empty or minimal content.
-metadata: { "openclaw": { "emoji": "🕸️", "requires": { "bins": ["python3", "curl"] } } }
----
-
-# Web Scraper
-
-Server-side web page scraping with two modes. **No extra pip packages needed** -- uses only curl, Chrome, and PyMuPDF (already in the Docker image).
-
-## When to Use
-
-- `web_fetch` returned empty or very short content (common with SPA/JS-heavy sites)
-- The user explicitly asks to scrape or crawl a URL
-
-## Quick Start
-
-```bash
-# Static scrape (fast, curl + text extraction, works for most pages)
-python3 {baseDir}/scripts/scrape.py "https://example.com"
-
-# Dynamic scrape (Chrome renders JS, saves PDF, PyMuPDF extracts text)
-python3 {baseDir}/scripts/scrape.py "https://www.bitmain.com/" --mode dynamic
-```
-
-## Options
-
-| Option                   | Default  | Description                                                                        |
-| ------------------------ | -------- | ---------------------------------------------------------------------------------- |
-| `--mode static\|dynamic` | `static` | `static`: curl fetch + regex text extract. `dynamic`: Chrome PDF render + PyMuPDF. |
-| `--timeout <seconds>`    | `15`     | Request/render timeout                                                             |
-| `--max-chars <n>`        | `50000`  | Truncate output beyond this length                                                 |
-
-## Decision Logic
-
-1. **Try static mode first** (fast, < 2 seconds).
-2. If the result `text` is very short (< 200 characters) or empty, the page likely needs JavaScript.
-3. **Retry with `--mode dynamic`** to render JavaScript via headless Chrome.
-4. If dynamic mode fails (no Chrome), report the error to the user.
-
-## Output Format
-
-JSON to stdout:
-
-```json
-{
-  "status": "ok",
-  "mode": "dynamic",
-  "url": "https://www.bitmain.com/",
-  "title": "BITMAIN",
-  "text": "BITMAIN\nProducts\nBitcoin Miner S23 Hyd...",
-  "length": 1779
-}
-```
-
-## Modes Explained
-
-### Static Mode (`--mode static`)
-
-- Uses `curl` to fetch raw HTML
-- Regex-based tag stripping for text extraction
-- Fast (< 2 seconds), no Python dependencies needed
-- Does NOT execute JavaScript
-- Good for: documentation, blogs, news, static content
-
-### Dynamic Mode (`--mode dynamic`)
-
-- Chrome `--headless=new --print-to-pdf` renders the page including all JavaScript
-- PyMuPDF (`fitz`) extracts text from the resulting PDF
-- Slower (15-40 seconds) but captures dynamically generated content
-- Requires `google-chrome` or `chromium` on PATH
-- Good for: SPA (React/Vue/Angular), JS-rendered dashboards
-
-## Examples
-
-```bash
-# Basic static scrape
-python3 {baseDir}/scripts/scrape.py "https://docs.python.org/3/tutorial/index.html"
-
-# SPA page (needs JavaScript rendering)
-python3 {baseDir}/scripts/scrape.py "https://www.bitmain.com/" --mode dynamic
-
-# Longer timeout for slow pages
-python3 {baseDir}/scripts/scrape.py "https://slow-site.example.com" --mode dynamic --timeout 30
-```
-
-## Dependencies
-
-| Tool                         | Required For             | Already Installed      |
-| ---------------------------- | ------------------------ | ---------------------- |
-| `python3`                    | Script runtime           | Yes (Docker image)     |
-| `curl`                       | Static mode              | Yes (Docker image)     |
-| `google-chrome` / `chromium` | Dynamic mode only        | Depends on image       |
-| `PyMuPDF` (fitz)             | Dynamic mode PDF reading | Yes (requirements.txt) |
-| `pdfminer`                   | Fallback PDF reading     | Yes (requirements.txt) |
-
-## Security
-
-- Only `http://` and `https://` URLs are allowed
-- Requests to `localhost`, private IPs, and reserved addresses are blocked (SSRF protection)
-- Output is truncated at `--max-chars` to prevent excessive memory usage
+---
+name: web-scraper
+description: Scrape web pages on the server side. Supports static HTTP scraping (curl) and dynamic JavaScript rendering (Chrome print-to-pdf + PyMuPDF). Zero extra pip dependencies. Use when web_fetch returns empty or minimal content.
+metadata: { "openclaw": { "emoji": "🕸️", "requires": { "bins": ["python3", "curl"] } } }
+---
+
+# Web Scraper
+
+Server-side web page scraping with two modes. **No extra pip packages needed** -- uses only curl, Chrome, and PyMuPDF (already in the Docker image).
+
+## When to Use
+
+- `web_fetch` returned empty or very short content (common with SPA/JS-heavy sites)
+- The user explicitly asks to scrape or crawl a URL
+
+## Quick Start
+
+```bash
+# Static scrape (fast, curl + text extraction, works for most pages)
+python3 {baseDir}/scripts/scrape.py "https://example.com"
+
+# Dynamic scrape (Chrome renders JS, saves PDF, PyMuPDF extracts text)
+python3 {baseDir}/scripts/scrape.py "https://www.bitmain.com/" --mode dynamic
+```
+
+## Options
+
+| Option                   | Default  | Description                                                                        |
+| ------------------------ | -------- | ---------------------------------------------------------------------------------- |
+| `--mode static\|dynamic` | `static` | `static`: curl fetch + regex text extract. `dynamic`: Chrome PDF render + PyMuPDF. |
+| `--timeout <seconds>`    | `15`     | Request/render timeout                                                             |
+| `--max-chars <n>`        | `50000`  | Truncate output beyond this length                                                 |
+
+## Decision Logic
+
+1. **Try static mode first** (fast, < 2 seconds).
+2. If the result `text` is very short (< 200 characters) or empty, the page likely needs JavaScript.
+3. **Retry with `--mode dynamic`** to render JavaScript via headless Chrome.
+4. If dynamic mode fails (no Chrome), report the error to the user.
+
+## Output Format
+
+JSON to stdout:
+
+```json
+{
+  "status": "ok",
+  "mode": "dynamic",
+  "url": "https://www.bitmain.com/",
+  "title": "BITMAIN",
+  "text": "BITMAIN\nProducts\nBitcoin Miner S23 Hyd...",
+  "length": 1779
+}
+```
+
+## Modes Explained
+
+### Static Mode (`--mode static`)
+
+- Uses `curl` to fetch raw HTML
+- Regex-based tag stripping for text extraction
+- Fast (< 2 seconds), no Python dependencies needed
+- Does NOT execute JavaScript
+- Good for: documentation, blogs, news, static content
+
+### Dynamic Mode (`--mode dynamic`)
+
+- Chrome `--headless=new --print-to-pdf` renders the page including all JavaScript
+- PyMuPDF (`fitz`) extracts text from the resulting PDF
+- Slower (15-40 seconds) but captures dynamically generated content
+- Requires `google-chrome` or `chromium` on PATH
+- Good for: SPA (React/Vue/Angular), JS-rendered dashboards
+
+## Examples
+
+```bash
+# Basic static scrape
+python3 {baseDir}/scripts/scrape.py "https://docs.python.org/3/tutorial/index.html"
+
+# SPA page (needs JavaScript rendering)
+python3 {baseDir}/scripts/scrape.py "https://www.bitmain.com/" --mode dynamic
+
+# Longer timeout for slow pages
+python3 {baseDir}/scripts/scrape.py "https://slow-site.example.com" --mode dynamic --timeout 30
+```
+
+## Dependencies
+
+| Tool                         | Required For             | Already Installed      |
+| ---------------------------- | ------------------------ | ---------------------- |
+| `python3`                    | Script runtime           | Yes (Docker image)     |
+| `curl`                       | Static mode              | Yes (Docker image)     |
+| `google-chrome` / `chromium` | Dynamic mode only        | Depends on image       |
+| `PyMuPDF` (fitz)             | Dynamic mode PDF reading | Yes (requirements.txt) |
+| `pdfminer`                   | Fallback PDF reading     | Yes (requirements.txt) |
+
+## Security
+
+- Only `http://` and `https://` URLs are allowed
+- Requests to `localhost`, private IPs, and reserved addresses are blocked (SSRF protection)
+- Output is truncated at `--max-chars` to prevent excessive memory usage