CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-gds-skill

Neo4j Graph Data Science (GDS) embedded plugin via Python client or Cypher — covers graphdatascience client 2.x, GraphDataScience, gds.graph.project.native, gds.graph.project.cypher, snake_case endpoints, graph catalog operations, stream/stats/mutate/write modes, memory estimation, PageRank, Louvain, WCC, FastRP, KNN, Node Similarity, ML pipelines, and cleanup. Use for Aura Pro, self-managed, local, or offline Neo4j DBMS with the GDS plugin installed. Does NOT cover Aura Graph Analytics GDS Sessions, AuraGraphDataScience, GdsSessions, gds.graph.project.remote, or AuraDB Cypher API projection/session management — use neo4j-aura-graph-analytics-skill. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT cover driver setup — use neo4j-driver-python-skill or other driver skill.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable reference body with complete executable examples, explicit validation checkpoints and error-recovery loops, and correctly split one-level-deep bundle references. The only weakness is minor token redundancy: a duplicated Leiden sentence, repeated session-routing lines, and scattered version notes that could be consolidated.

Suggestions

Deduplicate the verbatim-repeated Leiden/undirected-relationship sentence (appears in both Undirected Projection and Louvain sections), keeping it only where users decide on orientation.

Consolidate the scattered time-sensitive version notes (2026.09/2026.10 compatibility, 2026.07.0 userLog removal) into the existing 1.x/compatibility area or a single version-notes block.

Trim the repetition of AGA-session routing (stated ~6 times) to the When NOT to Use section plus one pointer at the Cypher projection call site.

DimensionReasoningScore

Conciseness

The body is dense tables and executable code with essentially no explanation of concepts Claude already knows, and version-specific material is mostly quarantined in the "Client 1.x fallback" section. Minor trims remain: the sentence "Leiden is defined for directed and undirected graphs. Project undirected relationships when community structure is naturally symmetric" appears verbatim in both the Undirected Projection and Louvain sections, AGA-session routing is repeated about six times, and scattered time-sensitive notes (2026.09/2026.10 compat, 2026.07.0 userLog removal) sit in Pre-flight rather than one consolidated section. This fits anchor 4 — efficient with minor instances that could be trimmed — rather than anchor 5 where every token earns its place, and clearly above anchor 3's unnecessary explanations.

4 / 5

Actionability

Copy-paste-ready Python and Cypher cover the common cases: native and Cypher projection, memory estimation, stream/mutate/write for each core algorithm, a complete five-step FastRP→KNN pipeline ending in gds.graph.drop, and an eleven-row error→cause→fix table. This matches the fully executable, common-case-covering anchor 5.

5 / 5

Workflow Clarity

The Full Workflow numbers steps with explicit validation checkpoints (verify plugin via gds.server_version(), estimate memory before large work), the stream→mutate→write pattern validates before persisting, a confirmation gate precedes any write-cypher, and a Common Errors table plus end checklist provide feedback loops and error recovery for the destructive/batch operations (DB writes, graph drops). Validation is present, so the destructive-operation cap does not apply; this matches anchor 5 rather than anchor 4's minor validation gaps.

5 / 5

Progressive Disclosure

The body is a clear overview and both in-body references (references/algorithms.md, references/graph-projection.md) are real files, exactly one level deep, each signaled with a one-line description of its contents; the bulk algorithm catalog and projection deep-dive correctly live in those files rather than inline. This matches anchor 5; only mild overlap exists between the body's quick examples and the references' deep dives, which is not the disorganization of anchor 4.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, complete description with explicit use-for triggers and unusually thorough negative-scope routing to sibling skills. The only gap is a few natural-language synonyms (centrality, community detection, embeddings) that users might phrase differently from the API names listed.

Suggestions

Add natural-language synonyms such as "graph algorithms", "centrality", "community detection", and "node embeddings" so the description triggers on how users phrase goals rather than only API names.

DimensionReasoningScore

Specificity

The description enumerates a comprehensive set of concrete capabilities and API surface: "gds.graph.project.native, gds.graph.project.cypher, snake_case endpoints, graph catalog operations, stream/stats/mutate/write modes, memory estimation, PageRank, Louvain, WCC, FastRP, KNN, Node Similarity, ML pipelines, and cleanup". This matches the anchor for multiple specific concrete actions with comprehensive coverage; no evident capability gaps pull it to 4.

5 / 5

Completeness

Both what ("covers graphdatascience client 2.x, ... ML pipelines, and cleanup") and when ("Use for Aura Pro, self-managed, local, or offline Neo4j DBMS with the GDS plugin installed") are explicitly stated with concrete trigger phrases, plus explicit negative scope. This matches anchor 5; the when-clause is concrete, not the weaker form of anchor 4.

5 / 5

Trigger Term Quality

Natural keywords users would say are present ("PageRank", "Louvain", "KNN", "Node Similarity", "memory estimation", "Neo4j Graph Data Science (GDS)"), but common natural synonyms like "graph algorithms", "centrality", "community detection", and "node embeddings" are missing — coverage relies partly on API/procedure names. Good coverage with a few natural terms missing fits anchor 4 rather than the comprehensive synonym coverage of anchor 5, and clearly exceeds anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

Clear niche (embedded GDS plugin) with explicit boundary routing against every adjacent skill: "Does NOT cover Aura Graph Analytics GDS Sessions ... use neo4j-aura-graph-analytics-skill. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT cover driver setup". Minimal conflict risk, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

neo4j-contrib/neo4j-skills

Path

neo4j-gds-skill/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.