OpenSearch Agent Skills

August 6, 2026 · View on GitHub

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
Cloud	managed-ingestion-service	Ingest chunks at scale via OSIS pipelines with ASE
Cloud	aiven-setup	Deploy to Aiven for OpenSearch (managed, multi-cloud)

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

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