elasticsearch-migration

Coordinate an end-to-end Elasticsearch-to-Vespa migration with mapping, translation, and deployment.

14|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/vespaai-playground/skills --skill elasticsearch-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: elasticsearch-migration
Source: https://github.com/vespaai-playground/skills/tree/main/elasticsearch-migration
Command: npx skills add https://github.com/vespaai-playground/skills --skill elasticsearch-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates from Elasticsearch to Vespa by coordinating the end-to-end process: mapping ES indices to Vespa schemas, translating queries to YQL, planning reindexing, and reconciling ranking differences.

Core Features & Use Cases

  • End-to-end migration coordinator that delegates to specialized Vespa skills (schema-authoring, app-package, query-builder, feed-operations, vespa-cli, pyvespa).
  • Phase-based workflow: export mappings, convert mappings, generate app package, deploy, feed, and verify results while guiding on ranking divergence and validation checkpoints.
  • Fresh-doc fetching patterns to stay current with live Vespa and ES docs without embedding stale content.

Quick Start

Export your ES mapping and documents, run ES_Vespa_parser to generate a skeleton Vespa app, deploy it, and feed a small sample while testing a representative query.

Frequently Asked Questions about elasticsearch-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an Elasticsearch index to Vespa?

Migrating an Elasticsearch index to Vespa involves exporting ES mappings and documents, converting mappings to Vespa schemas, deploying the app package, feeding data, and validating queries. This process coordinates schema translation and reindexing to ensure successful cutover.

How do I translate Elasticsearch Query DSL to Vespa YQL?

Translating Elasticsearch Query DSL to Vespa YQL requires converting query structures into Vespa's native query language. The migration process includes query translation steps that map ES search logic to YQL syntax while reconciling ranking differences.

How do I map Elasticsearch indices to Vespa schemas?

Mapping Elasticsearch indices to Vespa schemas requires converting ES index mappings into Vespa .sd schema definition files. The migration workflow exports existing ES mappings and transforms them into the Vespa schema format for deployment.

What is the best way to handle ranking differences when moving from Elasticsearch to Vespa?

Handling ranking differences during an Elasticsearch to Vespa migration requires explicit ranking alignment steps within the migration workflow. The process includes validation checkpoints to reconcile scoring divergences and ensure query relevance parity before cutover.

Do I need to use Vespa CLI and app packages for an Elasticsearch migration?

Yes, an Elasticsearch to Vespa migration orchestrates specialized tools including vespa-cli, app-package, schema-authoring, and feed-operations skills. These coordinate the deployment, schema generation, and data feeding required for a complete migration.

Can I test a small sample of Elasticsearch data before fully migrating to Vespa?

Yes, the migration workflow supports feeding a small data sample into the deployed Vespa application while testing representative queries. This validation checkpoint approach lets you verify schema mapping and ranking alignment before full cutover.