← Back to Skills Marketplace
ragret-search
by
SugarSong404
· GitHub ↗
· v1.0.0
· MIT-0
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ragret-search
Description
Search, retrieval, or knowledge-base intent when the user does not clearly mean local files only or the open web: curl a remote RAGret API for semantic retri...
Usage Guidance
This skill appears to be a simple helper for querying a RAGret server, but before installing: 1) Note that SKILL.md expects an API key (RAGRET_API_KEY) and a BASE/BASE_URL even though the package metadata doesn't declare those env vars — confirm how you'll supply them (set locally, not pasted into chat). 2) Verify and confirm the RAGret base URL before use (the skill defaults to http://127.0.0.1:8765 if unsure), since that will cause network calls to local or remote hosts. 3) Ensure you trust the RAGret instance you will query (it will receive queries and your API key via curl headers). 4) Ask the publisher to update the skill metadata to declare the required environment variables and primary credential so the permission surface is explicit. If you are uncomfortable with an agent making network requests or providing an API key, do not install or disable autonomous invocation for this skill.
Capability Analysis
Type: OpenClaw Skill
Name: ragret-search
Version: 1.0.0
The skill utilizes shell-based network access via `curl` to interact with a remote or local API, which is a risky capability. While the behavior is aligned with the stated purpose of RAG retrieval, the instructions in `SKILL.md` involve constructing shell commands using variables like `$BASE`, `INDEX_NAME`, and `$RAGRET_API_KEY`, which presents a risk of command injection or accidental data exfiltration if the agent does not properly sanitize user-provided inputs. The skill correctly includes instructions to avoid requesting raw secrets in chat, but the reliance on shell execution for API interaction warrants a cautious classification.
Capability Assessment
Purpose & Capability
The skill's name and description match the instructions: it is a thin wrapper that issues curl requests to a RAGret API for semantic retrieval. That capability is coherent with the stated purpose.
Instruction Scope
The SKILL.md contains concrete curl commands and explicit guidance (listing indexes, search endpoint, parse .result). It correctly instructs the agent not to ask for secrets in chat. One small scope concern: it tells the agent to default to a local URL (http://127.0.0.1:8765) if the base URL is unclear, which means the agent may attempt local network calls automatically if the user doesn't confirm—this behavior should be explicit to users.
Install Mechanism
Instruction-only skill with no install spec and no code files; nothing is written to disk and no external packages are pulled in. This is the lowest-risk install surface.
Credentials
The SKILL.md expects RAGRET_API_KEY and a BASE/BASE_URL to be present in the local environment and shows curl headers (X-API-Key or Authorization: Bearer). However, the skill metadata declares no required environment variables or primary credential. That mismatch is an incoherence: the skill will need secrets to operate but does not declare them, which could lead to surprising behavior or misconfiguration.
Persistence & Privilege
The skill is not always-enabled and uses default autonomous invocation settings. It does not request system-wide configuration changes or extra persistence from the agent.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ragret-search - After installation, invoke the skill by name or use
/ragret-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the ragret-search skill for semantic retrieval using a RAGret API.
- Guides users to clarify intended retrieval scope (RAGret knowledge base, open-web, or local files).
- Provides detailed instructions for listing available indexes and performing searches via curl.
- Handles missing information by prompting for the RAGret server URL or API key only when necessary.
- Includes usage rules for showing sources and handling responses securely.
- Instructions and example usage are documented for ease of integration.
Metadata
Frequently Asked Questions
What is ragret-search?
Search, retrieval, or knowledge-base intent when the user does not clearly mean local files only or the open web: curl a remote RAGret API for semantic retri... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.
How do I install ragret-search?
Run "/install ragret-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ragret-search free?
Yes, ragret-search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ragret-search support?
ragret-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ragret-search?
It is built and maintained by SugarSong404 (@sugarsong404); the current version is v1.0.0.
More Skills