neo4j-vector-index-skill

Create and query Neo4j vector indexes for semantic similarity search.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-vector-index-skill-cardox6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-vector-index-skill
Source: https://github.com/cardox6/steuer-graph/tree/main/.agents/skills/neo4j-vector-index-skill
Command: npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-vector-index-skill-cardox6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires neo4j, and includes references (resource) components.

What problem does it solve? Setting up vector search in Neo4j involves version-specific syntax, index configuration choices, and embedding pipeline pitfalls that silently produce wrong results. This Skill provides the correct Cypher patterns for creating vector indexes, ingesting embeddings, and running similarity search across Neo4j versions. ## Core Features & Use Cases - Vector Index Management: Create node or relationship vector indexes with dimensions, similarity functions, HNSW parameters, and quantization options, then poll until ONLINE. - Similarity Search: Run nearest-neighbor queries using the SEARCH clause (Neo4j 2026.01+) or the db.index.vector.queryNodes() procedure fallback, with in-index filtering on declared properties. - Embedding Ingestion: Batch-store embeddings with Python UNWIND patterns or generate them in-Cypher with ai.text.embed(), plus hybrid search combining vector and fulltext sources via WRRF ranking. - Use Case: You are building a document Q&A system on Neo4j and need to index text chunk embeddings, then retrieve the most relevant chunks filtered by source and language before passing them to an LLM. ## Quick Start Ask the assistant to create a Neo4j vector index on Chunk nodes with 1536 dimensions and cosine similarity, then run a semantic search query against it.

Frequently Asked Questions about neo4j-vector-index-skill

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

FAQPage Schema
How do I create a vector index in Neo4j?▼

Use CREATE VECTOR INDEX with the label, embedding property, and OPTIONS containing vector.dimensions and vector.similarity_function. The dimensions must exactly match your embedding model output, and you must poll SHOW VECTOR INDEXES until the state is ONLINE before querying.

How to run vector similarity search in Neo4j Cypher?▼

On Neo4j 2026.01 or later, use the SEARCH clause with VECTOR INDEX, a query embedding, and LIMIT. On 2025.x versions, call db.index.vector.queryNodes with the index name, top-k count, and query vector, then filter results in a WHERE clause.

Should I use cosine or euclidean similarity for embeddings?▼

Use cosine for normalized embeddings from providers like OpenAI, Cohere, Voyage, and Google. Use euclidean only when the model was trained with L2 loss and raw distance matters. When documentation is silent, default to cosine.

Why does my Neo4j vector search return wrong or no results?▼

Common causes are querying before the index reaches ONLINE state, a dimension mismatch between stored embeddings and vector.dimensions, or using different embedding models at ingest and query time. Verify with vector.similarity.cosine on known similar pairs.

Can I filter vector search results by node properties in Neo4j?▼

Yes, on Neo4j 2026.01+ declare filterable properties in the WITH clause at index creation, then use them in the SEARCH WHERE clause with AND-only scalar predicates. On older versions, over-fetch with the queryNodes procedure and post-filter in WHERE.

When should I not use the Neo4j vector index approach?▼

Use neo4j-graphrag-skill for full GraphRAG retrieval pipelines, neo4j-cypher-skill for fulltext-only keyword search, and neo4j-gds-skill for computing graph embeddings like FastRP or Node2Vec. Vector indexes only cover storage and similarity lookup of existing embeddings.