← Back to Skills Marketplace
Opensearch Vector Search
by
norrishuang
· GitHub ↗
· v1.3.2
· MIT-0
197
Downloads
0
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install opensearch-vector-search
Description
Amazon OpenSearch vector search expert knowledge base. Comprehensive guidance on vector search configuration, cluster tuning, quantization, cost optimization...
Usage Guidance
This skill appears coherent with its stated purpose, but take these precautions before running anything or providing credentials:
- Inspect the two scripts (scripts/analyze_cluster.py and scripts/get_opensearch_pricing.py) yourself or run them in an isolated environment to confirm they only perform read-only API calls and send data only to expected endpoints (your OpenSearch cluster and AWS Pricing API).
- When asked to provide OpenSearch credentials, supply a least-privilege account (read-only, limited indices) rather than an admin user. Prefer short-lived credentials if possible.
- For AWS pricing, use an IAM user/role with minimal permissions required for the Pricing API (or run the script locally under your own AWS profile) and rotate any credentials after use.
- Do not allow the agent to automatically execute example curl/PUT/POST snippets from the references; treat those as documentation only.
- Review network activity (outbound connections) when running the scripts to ensure no unexpected endpoints receive data.
If you want additional assurance, paste the full contents of the two scripts here (or review them locally) and I can point out any lines that attempt to write, modify indices, or contact unexpected hosts. If you cannot review the code, consider running it on a disposable machine or container with no credentials first.
Capability Analysis
Type: OpenClaw Skill
Name: opensearch-vector-search
Version: 1.3.2
The skill bundle is a comprehensive expert system for Amazon OpenSearch vector search, providing documentation and diagnostic tools. It includes two Python scripts: `get_opensearch_pricing.py`, which uses the AWS Pricing API (boto3) to fetch public pricing data, and `analyze_cluster.py`, which performs read-only analysis of OpenSearch clusters. While the latter requires cluster credentials, the code and the instructions in `SKILL.md` are explicitly restricted to read-only operations (using GET and CAT APIs) for health checks and configuration reviews. No evidence of data exfiltration, malicious execution, or deceptive prompt injection was found; the functionality aligns entirely with the stated purpose of cluster optimization and capacity planning.
Capability Assessment
Purpose & Capability
The name/description (OpenSearch vector search KB + live analysis + pricing) matches the included artifacts: reference docs, a cluster analyzer script, and an AWS pricing script. Declared tools (python3, boto3, opensearch-py) and optional AWS env vars are proportional to the pricing and analysis features.
Instruction Scope
SKILL.md explicitly warns not to execute reference examples automatically and states the scripts are read-only and run only with explicit user consent. That scope is appropriate, but running the analyzer requires the user to provide cluster credentials — that grants the script read access to cluster state and metadata, so users should only provide least-privilege credentials and inspect the script before running. The SKILL.md's instructions are reasonably scoped but rely on operator discipline.
Install Mechanism
This is instruction-only (no install spec). There are two Python scripts included but no automatic installation or remote download steps. No high-risk download URLs or archive extraction were specified in the manifest.
Credentials
No required environment variables are forced; AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are declared optional and explicitly documented as only necessary for running the pricing script. No unrelated credentials, config paths, or excessive env requirements are requested.
Persistence & Privilege
The skill does not request persistent presence (always:false) and does not claim to modify other skill configs. It requires explicit user action to run scripts that may open network connections.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install opensearch-vector-search - After installation, invoke the skill by name or use
/opensearch-vector-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
- Added version, repository, and GitHub community links to SKILL.md.
- Improved documentation formatting and clarity in the introduction.
- No workflow or logic changes; content and core workflows remain the same.
- Audience is now encouraged to submit issues or PRs via the repository link.
v1.3.1
Add Graviton4 c8g/m8g/r8gd instance types
v1.3.0
v1.3.0: New feature - Live Cluster Analyzer. Connect to any OpenSearch cluster with URL + credentials, auto-discover all k-NN indices, deep-dive vector field configs (engine, HNSW params, quantization, disk mode), compute memory estimates, analyze shard distribution, and auto-generate optimization recommendations. Strictly read-only - never modifies the cluster. New script: scripts/analyze_cluster.py. Updated SKILL.md with Workflow 4 (Live Cluster Analysis) and safety constraints.
v1.2.1
Security review fixes: declared AWS credentials as optional env requirements, added Safety Notes section clarifying pricing script is read-only HTTPS to AWS Pricing API, documented that localhost:9200 examples in references are documentation-only and should not be auto-executed, added security header to pricing script.
v1.2.0
Added OpenSearch Optimized Instances guide (OR1/OR2/OM2/OI2). Restricted instance recommendations to Gen 7+ only. Added instance selection decision tree.
v1.1.0
Translated all content to English (SKILL.md + 7 reference docs). No functional changes.
v1.0.0
Initial release: vector search config, cluster sizing, quantization, AWS pricing integration
Metadata
Frequently Asked Questions
What is Opensearch Vector Search?
Amazon OpenSearch vector search expert knowledge base. Comprehensive guidance on vector search configuration, cluster tuning, quantization, cost optimization... It is an AI Agent Skill for Claude Code / OpenClaw, with 197 downloads so far.
How do I install Opensearch Vector Search?
Run "/install opensearch-vector-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Opensearch Vector Search free?
Yes, Opensearch Vector Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Opensearch Vector Search support?
Opensearch Vector Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Opensearch Vector Search?
It is built and maintained by norrishuang (@norrishuang); the current version is v1.3.2.
More Skills