
Choose the right embedding model and chunking strategy for your vector search setup. Covers Voyage AI models (Anthropic's recommendation for Claude apps), OpenAI's text-embedding-3 series with Matryoshka dimension reduction, and local options like BGE and E5. Includes domain-specific models for code, finance, and legal documents. Templates handle token-based chunking, sentence boundaries, and semantic sectioning by headers. The model comparison table saves you from benchmarking common options yourself. Most useful when you're past the "just use whatever" phase and need to optimize retrieval quality or costs.
$ npx -y skills add wshobson/agents --skill embedding-strategies --agent claude-codeInstalls into .claude/skills of the current project.
Guide to selecting and optimizing embedding models for vector search applications.
| Model | Dimensions | Max Tokens | Best For |
|---|---|---|---|
| voyage-3-large | 1024 | 32000 | Claude apps (Anthropic recommended) |
| voyage-3 | 1024 | 32000 | Claude apps, cost-effective |
| voyage-code-3 | 1024 | 32000 | Code search |
| voyage-finance-2 | 1024 | 32000 | Financial documents |
| voyage-law-2 | 1024 | 32000 | Legal documents |
| text-embedding-3-large | 3072 | 8191 | OpenAI apps, high accuracy |
| text-embedding-3-small | 1536 | 8191 | OpenAI apps, cost-effective |
| bge-large-en-v1.5 | 1024 | 512 | Open source, local deployment |
| all-MiniLM-L6-v2 | 384 | 256 | Fast, lightweight |
| multilingual-e5-large | 1024 | 512 | Multi-language |
Document → Chunking → Preprocessing → Embedding Model → Vector
↓
[Overlap, Size] [Clean, Normalize] [API/Local]
Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.
Sponsors