BareGit

Add the SearXNG skill

Author: MetroWind <chris.corsair@gmail.com>
Date: Mon Mar 9 14:44:15 2026 -0700
Commit: c319bada66d045507fef04a9721f8b8c4521532f

Changes

diff --git a/skills/searxng-search/SKILL.md b/skills/searxng-search/SKILL.md
new file mode 100644
index 0000000..7300fde
--- /dev/null
+++ b/skills/searxng-search/SKILL.md
@@ -0,0 +1,48 @@
+---
+name: searxng-search
+description: Search the web using a private SearXNG instance.
+---
+
+# SearXNG Web Search
+
+Search the web and retrieve privacy-respecting results from a SearXNG
+meta-search engine instance.
+
+## Description
+
+This skill allows the agent to perform broad web searches across
+multiple engines (Google, Bing, DuckDuckGo, etc.) via a SearXNG
+endpoint, using curl in a shell command. It returns results in JSON
+format, including titles, URLs, and snippets.
+
+## Configuration
+
+To use this skill, ensure the environment variable `SEARXNG_URL` is
+set to your instance's base URL (e.g., `https://search.mydomain.com`).
+
+## Usage
+
+The agent uses this skill when it needs up-to-date information, news,
+or specific webpage links that are not in its training data.
+
+### Example Request
+
+"Search for the latest news on SpaceX Starship launches."
+
+```
+curl -X POST \
+  --data-urlencode "q=latest news SpaceX Starship launch" \
+  -d "format=json" \
+  "$SEARXNG_URL/search"
+```
+
+## SearXNG search API reference
+
+**Key Parameters**
+    - `q`: The search query string.
+    - `format`: Must be set to `json` for programmatic processing.
+    - `categories`: (Optional) Comma-separated list (e.g., `general`, `news`, `it`, `science`, `images`).
+    - `engines`: (Optional) Specific engines to query (e.g., `google`, `duckduckgo`, `wikipedia`).
+    - `language`: (Optional) Search language (e.g., `en-US`).
+    - `pageno`: (Optional) Results page number (starting from 1).
+    - `safesearch`: (Optional) `0` (None), `1` (Moderate), `2` (Strict).