plugin
Open on GitHub
opensearch — Claude Code plugin: features and installation
A set of skills for building OpenSearch search apps and analyzing observability data. Use it for semantic search, log analysis, traces, and cloud setup.
Install into Claude Code · Plugin marketplace
All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install opensearch@claude-community
/plugin install opensearch-agent-skills@claude-communityWhat opensearch does
This plugin adds OpenSearch skills for several workflows. opensearch-launchpad guides search app development with BM25, semantic, hybrid, and agentic approaches. log-analytics uses PPL for log queries, error patterns, and anomaly detection, while trace-analytics supports investigations of distributed traces and slow spans.
Cloud skills cover Amazon OpenSearch Service, OpenSearch Serverless, Aiven for OpenSearch, and ingestion through OSIS pipelines with ASE. The agent follows the skill instructions and runs scripts directly, so an MCP server is not required.
You need Python 3.11+, uv, and Docker running locally. AWS deployment also requires configured AWS credentials.
What it helps with
- build a semantic search application
- combine BM25 with semantic retrieval
- query logs for recurring errors with PPL
- inspect slow spans in distributed traces
- deploy OpenSearch on AWS or Aiven
Example prompts for the agent
- Build a semantic search app with OpenSearch.
- Query the logs with PPL and identify recurring error patterns.
- Inspect this distributed trace and find the slow spans.
How to install opensearch
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install opensearch@claude-community/plugin install opensearch-agent-skills@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about opensearch
How do I install opensearch in Claude Code?
Add the marketplace with /plugin marketplace add anthropics/claude-plugins-community, then run /plugin install opensearch@claude-community and /plugin install opensearch-agent-skills@claude-community.
What does the opensearch plugin do?
It provides skills for search application development, log and trace investigation, and OpenSearch deployment on cloud services.
What does opensearch require?
The setup requires Python 3.11+, uv, and a running Docker installation. AWS deployment also needs configured AWS credentials.
Source text
SKILL.md · Apache-2.0
# OpenSearch Agent Skills
A collection of [Agent Skills](https://agentskills.io/specification) for building search applications and analyzing observability data with OpenSearch. Works with Claude Code, Cursor, Kiro, and any agent that supports the Agent Skills standard.
---
## Available Skills
Skills are organized in a tree — install the whole collection or pick individual skills.
| Category | Skill | Description |
|----------|-------|-------------|
| **Search** | [opensearch-launchpad](skills/opensearch-skills/search/opensearch-launchpad/) | Build search apps from scratch — BM25, semantic, hybrid, agentic search |
| **Observability** | [log-analytics](skills/opensearch-skills/observability/log-analytics/) | Query and analyze logs with PPL — error patterns, anomaly detection |
| **Observability** | [trace-analytics](skills/opensearch-skills/observability/trace-analytics/) | Investigate distributed traces — slow spans, service maps, agent invocations |
| **Cloud** | [aws-setup](skills/opensearch-skills/cloud/aws-setup/) | Deploy to Amazon OpenSearch Service or Serverless |
| **Cloud** | [managed-ingestion-service](skills/opensearch-skills/cloud/managed-ingestion-service/) | Ingest chunks at scale via OSIS pipelines with ASE |
| **Cloud** | [aiven-setup](skills/opensearch-skills/cloud/aiven-setup/) | Deploy to Aiven for OpenSearch (managed, multi-cloud) |
> More skills coming soon — contributions welcome! See [DEVELOPER_GUIDE.md](DEVELOPER_GUIDE.md).
---
## Install
Install using [`npx skills`](https://agentskills.io):
```bash
# Install all skills
npx skills add opensearch-project/opensearch-agent-skills
# Install a specific skill
npx skills add opensearch-project/opensearch-agent-skills@opensearch-launchpad --full-depth
npx skills add opensearch-project/opensearch-agent-skills@log-analytics --full-depth
npx skills add opensearch-project/opensearch-agent-skills@trace-analytics --full-depth
npx skills add opensearch-project/opensearch-agent-skills@aws-setup --full-depth
npx skills add opensearch-project/opensearch-agent-skills@managed-ingestion-service --full-depth
npx skills add opensearch-project/opensearch-agent-skills@aiven-setup --full-depth
```
### Install options
```bash
# Install to a specific agent
npx skills add opensearch-project/opensearch-agent-skills -a claude-code
# Install globally (available across all projects)
npx skills add opensearch-project/opensearch-agent-skills -g
# Install to all detected agents
npx skills add opensearch-project/opensearch-agent-skills --all
# List available skills before installing
npx skills add opensearch-project/opensearch-agent-skills --list
```
### Claude Community Marketplace (Claude Code)
```bash
# Add the community marketplace (one-time setup)
/plugin marketplace add anthropics/claude-plugins-community
# Install the plugin
/plugin install opensearch-agent-skills@claude-community
# Reload to apply
/reload-plugins
```
After installing, try:
> *"I want to build a semantic search app with OpenSearch"*
Your agent reads the skill instructions and runs the scripts directly — no MCP server required.
---
## Prerequisites
- **Python 3.11+** and [`uv`](https://docs.astral.sh/uv/getting-started/installation/)
- **Docker** installed and running ([Download Docker](https://docs.docker.com/get-docker/))
- **For AWS deployment (optional):** AWS credentials configured
---
## Repo Structure
```
skills/
opensearch-skills/ # Top-level meta-skill
SKILL.md # Routes to category skills
cli-reference.md # Shared CLI command reference
scripts/ # Shared scripts, UI, sample data
search/ # Category: Search
SKILL.md
opensearch-launchpad/ # Search app builder
SKILL.md
*.md # Model guides, evaluation, strategies
observability/ # Category: Observability
SKILL.md
log-analytics/ # Log querying & analysis
SKILL.md
log-analytics.md
ppl-reference.md
trace-analytics/ # Distributed trace investigation
SKILL.md
traces.md
ppl-reference.md
ingest/ # Category: Ingest
SKILL.md
document-processing/ # Local document processing (Docling)
SKILL.md
document_processing_guide.md
cloud/ # Category: Cloud deployment
SKILL.md
aws-setup/ # AWS provisioning & deployment
SKILL.md
aos/ # Amazon OpenSearch Service guides
aoss/ # Amazon OpenSearch Serverless guides
reference.md
managed-ingestion-service/ # Cloud-scale ingestion via OSIS
SKILL.md
iam-setup.md
aiven-setup/ # Aiven provisioning & deployment
SKILL.md
aiven-01-provision.md # Provision the managed service
aiven-02-deploy-search.md # Deploy the search configuration
reference.md
tests/ # pytest test suite
```
---
## Contributing
We welcome new skills and improvements! See the [Developer Guide](DEVELOPER_GUIDE.md) for instructions on creating skills, conventions, testing, and the contribution process.
---
## License
This project is licensed under the Apache License, Version 2.0. See [LICENSE.txt](LICENSE.txt) for details.
© opensearch-project · Apache-2.0 · opensearch-project/opensearch-agent-skills
Similar plugins
All plugins for Backend and APIs →
amazon-opensearch-service Guides migration, provisioning, vector search, log analytics, and distributed tracing across Amazon OpenSearch Service and Serverless. Works with AWS CLI and agent tools.
CX Codex +1
5,500installs
digitalocean-managed-databases Provides database provisioning, scaling, and network security patterns for DigitalOcean. Useful when managing PostgreSQL, Redis, Kafka, or MySQL clusters.
CX Codex +1
393installs
azure-monitor A skill that hands the agent Azure Monitor know-how: agents, data collection rules, Log Analytics, App Insights, alerts and Prometheus.
CX Codex +1
352installs
azure-monitor-audit Configures Azure Monitor, Log Analytics, and Activity Logs for centralized auditing. It helps fulfill logging requirements for SOC 2, HIPAA, PCI DSS, or ISO 27001.
CX Codex +1
313installs
elasticsearch-mcp-server Connects an agent to Elasticsearch and OpenSearch tools for document search, index inspection, and cluster management. Useful when coding tasks depend on search data.
CX Codex +1
★ 314repo stars
azure-resource-health-diagnose
official This skill checks an Azure resource, uses its logs and telemetry to investigate issues, and drafts a remediation plan. Use it when you need to diagnose a specific resource.
8,700installs
