Elasticsearch development best practices for indexing, querying, mapping, and search optimization. Use this skill when designing indices, writing queries, configuring analyzers, or optimizing Elasticsearch cluster performance.
Comprehensive Elasticsearch development guide. Contains rules across 11 categories, prioritized by impact to guide automated index design, query optimization, and cluster management.
Reference these guidelines when:
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Mapping & Field Types | CRITICAL | mapping- |
| 2 | Query Optimization | CRITICAL |
query- |
| 3 | Index Settings & Sharding | HIGH | index- |
| 4 | Indexing & Bulk Operations | HIGH | bulk- |
| 5 | Analysis & Tokenization | HIGH | analysis- |
| 6 | Performance Optimization | MEDIUM-HIGH | perf- |
| 7 | Search Features | MEDIUM | search- |
| 8 | Aggregations | MEDIUM | agg- |
| 9 | Monitoring & Maintenance | LOW-MEDIUM | monitor- |
| 10 | Security | LOW-MEDIUM | security- |
| 11 | Aliases & Reindexing | LOW-MEDIUM | alias- |
Read individual rule files for detailed explanations and JSON examples:
references/mapping-explicit.md # Explicit mapping, field types
references/mapping-storage-optimization.md # index, doc_values, _source tuning
references/query-bool-filter.md # Filter context caching
references/query-term-vs-match.md # Query type vs field type
references/index-shard-sizing.md # Shard sizing guidelines
references/bulk-indexing.md # Bulk API throughput
references/analysis-custom.md # Custom analyzers
references/perf-segment-merge.md # Segment merge optimization
references/perf-pagination.md # search_after pagination
references/_sections.md # Section definitions
Each rule file contains: