OpenSearch Agent Skills

OpenSearch Agent Skills

A collection of Agent Skills 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	Build search apps from scratch — BM25, semantic, hybrid, agentic search
Observability	log-analytics	Query and analyze logs with PPL — error patterns, anomaly detection
Observability	trace-analytics	Investigate distributed traces — slow spans, service maps, agent invocations
Cloud	aws-setup	Deploy to Amazon OpenSearch Service or Serverless

More skills coming soon — contributions welcome! See DEVELOPER_GUIDE.md.

---

Install

Install using npx skills:

# 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

Install options

# 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)

# 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
• Docker installed and running (Download 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
    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
tests/                                # pytest test suite

---

Contributing

We welcome new skills and improvements! See the Developer Guide 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 for details.