Opensearch Skills

OpenSearch Skills

This is the top-level skill for OpenSearch. It contains three category skills that can also be installed and used independently:

| Category | Skill | Install individually | |---|---|---| | [search](search/SKILL.md) | [opensearch-launchpad](search/opensearch-launchpad/SKILL.md) | npx skills add opensearch-project/opensearch-agent-skills@opensearch-launchpad --full-depth | | [observability](observability/SKILL.md) | [log-analytics](observability/log-analytics/SKILL.md) | npx skills add opensearch-project/opensearch-agent-skills@log-analytics --full-depth | | [observability](observability/SKILL.md) | [trace-analytics](observability/trace-analytics/SKILL.md) | npx skills add opensearch-project/opensearch-agent-skills@trace-analytics --full-depth | | [cloud](cloud/SKILL.md) | [aws-setup](cloud/aws-setup/SKILL.md) | npx skills add opensearch-project/opensearch-agent-skills@aws-setup --full-depth |

Routing

Route to the right skill based on user intent:

| User Intent | Skill | |---|---| | Build a search app, set up an index, choose a search strategy | [opensearch-launchpad](search/opensearch-launchpad/SKILL.md) | | Analyze logs, query with PPL, discover error patterns | [log-analytics](observability/log-analytics/SKILL.md) | | Investigate traces, debug spans, analyze service maps | [trace-analytics](observability/trace-analytics/SKILL.md) | | Deploy to AWS, provision a domain or collection | [aws-setup](cloud/aws-setup/SKILL.md) | | General OpenSearch question | Search docs first, then route to the relevant skill |

If the user's intent spans multiple skills (e.g., "build a search app and deploy it to AWS"), start with the appropriate skill and transition to the next when ready.

Shared Resources

All skills share these resources:

• Scripts: scripts/opensearch_ops.py — CLI for all OpenSearch operations
• Docker bootstrap: scripts/start_opensearch.sh — Start a local OpenSearch cluster
• CLI Reference: [cli-reference.md](cli-reference.md) — Full command reference with examples
• Search Builder UI: scripts/ui/ — React frontend served on port 8765

bash scripts/start_opensearch.sh
uv run python scripts/opensearch_ops.py  [options]
uv run python scripts/opensearch_ops.py --help

Optional MCP Servers

{
  "mcpServers": {
    "ddg-search": {
      "command": "uvx",
      "args": ["duckduckgo-mcp-server"]
    },
    "awslabs.aws-api-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-api-mcp-server@latest"],
      "env": { "FASTMCP_LOG_LEVEL": "ERROR" }
    },
    "aws-knowledge-mcp-server": {
      "command": "uvx",
      "args": ["fastmcp", "run", "https://knowledge-mcp.global.api.aws"],
      "env": { "FASTMCP_LOG_LEVEL": "ERROR" }
    },
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": ["opensearch-mcp-server-py@latest"],
      "env": { "FASTMCP_LOG_LEVEL": "ERROR" }
    }
  }
}

Auto-Installing Missing MCP Servers

Before using any MCP tool, check if the server is available. If missing:

1. Locate the MCP config file:

• Kiro: .kiro/settings/mcp.json
• Cursor: .cursor/mcp.json
• Claude Code: .mcp.json
• VS Code (Copilot): .vscode/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json

1. Read the existing config (or start with {"mcpServers": {}}).
2. Merge in the missing server entry. Do not overwrite existing entries.
3. Save and inform the user to restart or reconnect MCP servers.

Answering OpenSearch Knowledge Questions

uv run python scripts/opensearch_ops.py search-docs --query ""
uv run python scripts/opensearch_ops.py search-docs --query "" --site docs.aws.amazon.com

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: opensearch-project
• Source: opensearch-project/opensearch-agent-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.