neo4j-gds-skill

Execute Neo4j GDS algorithms via graph projections and stream, stats, mutate, or write modes.

101|35|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-gds-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neo4j-gds-skill
Source: https://github.com/neo4j-contrib/neo4j-skills/tree/main/neo4j-gds-skill
Command: npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-gds-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you run Neo4j Graph Data Science (GDS) graph algorithms reliably without manually wiring projections, choosing execution modes, or handling common GDS configuration pitfalls.

Core Features & Use Cases

  • Graph projection and graph catalog management: Create native and Cypher-based projections, inspect projected graphs, estimate memory, list catalog graphs, and drop them when finished.
  • Algorithm execution in the right mode: Use stream, stats, mutate, and write to control side effects and support pipelines like FastRP → KNN recommendations.
  • Core graph analytics and embeddings: Run PageRank, Louvain/Leiden-style community workflows, WCC, Betweenness Centrality, Node Similarity, FastRP embeddings, and KNN similarity search, including writing embeddings for later vector indexing.
  • Practical guardrails: Pre-flight checks (embedded plugin availability), compatibility expectations, and mitigations for common errors such as OOM, missing properties, or leftover catalog graphs.

Quick Start

Use the neo4j-gds-skill to project a graph and run PageRank on it, then write results back to Neo4j so they are queryable later.

Frequently Asked Questions about neo4j-gds-skill

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

FAQPage Schema
How do I run Neo4j GDS algorithms like PageRank and Louvain directly on my graph data?

To run Neo4j GDS algorithms, you must first create a graph projection, then execute the algorithm using stream, stats, mutate, or write modes to control whether results are returned, stored in memory, or written back to the database.

What is the correct way to use FastRP embeddings and KNN for similarity search in Neo4j?

FastRP embeddings and KNN similarity search in Neo4j require projecting the graph, generating the embeddings, and then running the KNN algorithm, often using mutate or write modes to save embeddings for later vector indexing.

Can I use Neo4j Graph Data Science with AuraDB session-based projections?

Neo4j Graph Data Science requires the embedded GDS plugin with a graphdatascience Python client or direct gds.* Cypher procedures. It does not support Aura Graph Analytics sessions or AuraDB session-based projection workflows.

How do I estimate memory before running large graph analytics workflows in Neo4j GDS?

You can estimate memory in Neo4j GDS by running a pre-flight estimation procedure on your graph projection before executing large analytics workflows, helping you avoid out-of-memory errors and ensure safe execution.

Why does my Neo4j GDS algorithm fail with missing properties or out of memory errors?

Neo4j GDS algorithms fail with missing properties or out-of-memory errors when graph projections lack required node properties or when memory estimation limits are exceeded, requiring pre-flight checks and catalog cleanup.

When should I use stream versus write mode for Neo4j graph data science algorithms?

Use stream mode for Neo4j graph data science algorithms to return results directly without side effects, and use write mode to persist algorithm results like PageRank scores back to the database for later querying.