neo4j-gds-skill

Runs Neo4j Graph Data Science algorithms via Python client or Cypher on embedded GDS plugin deployments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Running graph algorithms like PageRank, Louvain, or FastRP against Neo4j requires correct graph projection, memory estimation, execution mode selection, and version-aware API usage — mistakes cause OOM errors, failed procedures, or silently wrong results. This Skill provides verified patterns for the embedded GDS plugin so agents produce working code on the first attempt. ## Core Features & Use Cases - Graph Projection & Catalog Management: Native and Cypher projection, undirected orientation, subgraph filtering, memory estimation, and graph drop/list operations. - Algorithm Execution: PageRank, Louvain, Leiden, WCC, Betweenness Centrality, Node Similarity, FastRP embeddings, and KNN across stream/stats/mutate/write modes, with v2 Python client endpoints preferred and v1 fallbacks labeled. - Recommendation Pipelines: The FastRP → KNN pattern builds similarity relationships from node embeddings, ready for Neo4j vector indexes. - Use Case: A data engineer needs product recommendations from a co-purchase graph. The Skill projects the graph undirected, estimates memory, mutates FastRP embeddings, writes KNN similarity relationships, and drops the projection. ## Quick Start Ask the agent to project a named graph from your Neo4j database and run PageRank on it using the GDS Python client.

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 PageRank on Neo4j with the GDS Python client?▼

Create a GraphDataScience connection, project a named graph with gds.v2.graph.project, then call gds.v2.page_rank.stream or gds.v2.page_rank.write with parameters like damping_factor. Drop the projection afterward with gds.v2.graph.drop to free JVM heap.

How to build a recommendation pipeline with FastRP and KNN in Neo4j?▼

Project the graph undirected, mutate FastRP embeddings with a fixed random_seed, then run KNN write with node_properties set to the embedding to create SIMILAR relationships with score properties. Estimate memory before each step.

Does the graphdatascience Python client work with Aura Graph Analytics sessions?▼

No. This Skill covers only the embedded GDS plugin on Aura Pro, self-managed, or local Neo4j. Aura Graph Analytics sessions, GdsSessions, and remote projection require the neo4j-aura-graph-analytics-skill instead.

Why does my GDS projection fail with insufficient heap memory?▼

The projected graph exceeds available JVM heap. Run gds.graph.project.estimate first to check requiredMemory, then reduce the graph size or increase dbms.memory.heap.max_size. Treat 80% of heap as the review threshold.

What is the difference between stream, mutate, and write modes in GDS?▼

Stream returns per-node results without side effects, mutate adds properties to the in-memory graph for chaining algorithms, and write persists results to the Neo4j database. The standard pattern is stream to verify, mutate to chain, write to persist.

When should I use gds.v2 endpoints versus v1 in the Python client?▼

Prefer gds.v2 endpoints with snake_case parameters and typed result attributes whenever the endpoint exists. Fall back to v1 only for missing v2 coverage, such as plugin Cypher projection via gds.graph.cypher.project, and label the fallback explicitly.